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About This Book 



This book describes the general concepts, installation, configuration, and use of 
TME 10 Software Distribution, Version 3.1.5 for OS/2, hereafter also referred to as 
TME 10 Software Distribution. 



Who Should Use This Book 

This book is intended for information systems professionals who require a basic 
understanding of TME 10 Software Distribution in order to evaluate its suitability for 
software and data distribution and change control in networks based on the OS/2 
operating system. 



How This Book Is Organized 



This book has the following parts and chapters: 

Part 1, “Introd u ction to T M E 10 Software Distribution” 

This part includes chapters that provide conceptual information about the product. 
They are: 



• iChapter 1, “Overview of TME 10 Software Distribution”| describes the benefits 
you obtain by using change control functions to manage a network of 
workstations. It introduces different network topologies supported by 
TME 10 Software Distribution, outlines product users, and tells you how to start 
and stop the product. 



Chapter 2, “Setting Up a TME 10 Software Distribution Network” provides the 



information you need to configure the workstations in your network as 
TME 10 Software Distribution targets. 



Chapter 3, “Preparing Software for Change Control” describes what must be 



done to prepare software in the format required by TME 10 Software 
Distribution. 



• IChapter 4, “Using Change Control Operations’l describes change control and 
distribution functions, and introduces how to schedule operations in your 
network. 



• IChapter 5, “Tracking Network Operations”| describes the facilities provided by 
TME 10 Software Distribution to keep track of the hardware and software 
configurations on workstations in your network. 

• IChapter 6, “Using Security Functions’l describes the security facilities provided 
by TME 10 Software Distribution. 

• IChapter 7, “Finding and Using TME 10 Software Distribution Information”! 
indicates where you can turn to find additional information required to use 
TME 10 Software Distribution functions. 
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XIX 



How This Book Is Organized 



Part 2, “Installing and Configuring T M E 10 Software D istribution” 

This part provides you with the information you need to install and configure the 
product. It includes the following chapters: 



Ch apter 8, “Planning”! identifies the hardware and software requirements for 



installing a TME 10 Software Distribution, Version 3.1.5 for OS/2 server. 



Cha p ter 9, “Installing an OS/2 Distribution Server”| explains how to install a 



TME 10 Software Distribution server and how to configure for various 
connectivity options. 

IChapter 10, “Editing the Base Configuration File”| explains how to configure 
TME 10 Software Distribution after installation. 

IChapter 11, “Defining Users and Targets”! explains how to define users and 
targets. 



Chapter 12, “Configuring for Communication with MVS”| explains how to 



configure prerequisite products for connectivity with a NetView DM for MVS focal 
point. 



Chapter 13, “Configuring Personal Communications/Communications Server” 
explains how to configure Personal Communications for various connectivity 
options. 



Chapter 14, “Configuring STS Remote Connection Files”| explains how to 
configure server-to-server connections to other TME 10 Software Distribution 
systems. 



• IChapter 15, “Configuring SNA/DS Remote Connection Files”| explains how to 
configure SNA/DS connections to other TME 10 Software Distribution systems. 

Part 3, “T ME 10 Software Distribution Scenarios” | 

This part of the book includes the following chapters: 



Chapter 16, “Software Distribution Scenarios”! presents typical user scenarios for 
preparing software for distribution, cataloging it, and installing it on client 
workstations. 



• IChapter 17, “Setting Up for CID Preparation”! explains how to set up the 
environment for CID software preparation. 

Part 4, “A p pendixes” I 

The manual has the following appendixes: 

• lAppendix A, “Installing TME 10 Software Distribution by Response File”| 
explains how to perform an unattended installation of TME 10 Software 
Distribution. 



lAppendix B, “Implementing Inventory Discovery! provides a description of the 
inventory discovery procedure. 



Appendix C, “Replacing the Quiesce Check”| describes how the quiesce check 
can be replaced at a target. It is used to see whether users are logged on at a 
target before operations are begun. 
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jAppendix D, “Writing Change Control Scripts”! describes change management 
scripts and how to create them. 



Appendix E, “Writing User Exits” on page 259| describes how to edit the C 
language source code provided with TME 10 Software Distribution to write user 
exits to create additional functions on a distribution server. 



Appendix F, “Application Definition File Considerations” on page 275| describes 



how to create an application definition file for use in CID software preparation. 

jAppendix G, “Setting Environment Variables”| describes how to set the 
environment variables. 



TME 10 Software Distribution Publications 

For conceptual information and installation instructions for the TME 10 Software 
Distribution family of products, consult the appropriate publications: 

• TME 10 Software Distribution for AIX Quick Beginnings, SHI 9-4333 

• TME 10 Software Distribution for OS/2 Quick Beginnings, SHI 9-4334 

• TME 10 Software Distribution for Windows NT and Windows 2000 Quick 
Beginnings, SHI 9-4335 

• TME 10 Software Distribution for NetWare Quick Beginnings, SHI 9-4341 

• TME 10 Software Distribution for NetWare Command Reference, SHI 9-4342 

• TME 10 Software Distribution Clients Installation and Configuration, SHI 9-4337 



Notation Used in This Book 



This book uses the following highlighting conventions in text: 



Bold 



Italics 



Monospacing 

UPPERCASE 



Bold print indicates choices made from a menu or action bar. It 
is also used to highlight fields and push buttons on panels. 

Italic print is used for introducing new terms in the text or for 
emphasis. 

Monospacing indicates system messages, special characters, 
statuses, directory names, user input, and examples. 

Uppercase letters are used for commands, devices, and file 
names. 



<angle brackets> Angle brackets are used to enclose the names of variables 
where you must substitute an appropriate value. 



Where a command and its associated parameters are too long to be shown on one 
line, the symbol V’ at the end of a line means that the next line is a continuation of the 
command string. When you enter the command, enter it all on one line. 
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What's New in This Release 



Release 3.1.5 of TME 10 Software Distribution contains the following new or changed 
functionalities: 



Support for New Platforms 

TME 10 Software Distribution, Version 3.1.5 adds support for the following platforms: 

• Windows 2000 (Professional and Server) 

• Windows NT 4.0 (Service Pack 5 and 6a) 

• OS/2, version 4.5 (Warp server for e-business) 

• AIX, version 4.3.x 



New Pristine Scenarios 

TME 10 Software Distribution, Version 3.1.5 Client can be installed on a pristine 
workstation in the following environments: 

• Windows 2000 Professional 

• Windows 2000 Server 

• Windows NT 4.0 Server/Workstation 

• OS/2 4.5 (Warp Server for e-business) 

• AIX 4.3.3 

This is in addition to the following pristine installation environments, which are 
maintained from the previous release: 

• Windows 3.11 

• Windows 95 

• Windows NT Version 3.51 

• OS/2 3.0.x (Warp) 



Complete Pla tform Support Tab le 

iTable 1 on page xxivl shows details of the platforms on which TME 10 Software 

Distribution is available. The columns in the table contain the following information: 

Server Scratch Indicates whether the Server software can be installed from 

scratch. Scenarios describing how to carry out the scratch 
installations can be found in the relevant Quick Beginnings 
manuals. 



Server Upgrade 



Client Scratch 



Indicates which version of the TME 10 Software Distribution 
Server can be upgraded, by supply ing a reference that can be 
looked up in Table 2 on page xxv Scenarios describing how 



to carry out the upgrade can be found in the README file. 



Indicates whether the Client software can be installed from 
scratch. Scenarios describing how to carry out the scratch 
installations can be found in the Client Installation and 
Customization manual. 
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Client Pristine Indicates whether the Client software can be installed on a 

pristine workstation (i.e. a workstation with no operating 
system installed). Scenarios describing how to carry out the 
pristine installations can be found in the Pristine and Migration 
Scenarios manual or the Installation Scenarios for AIX manual. 

Client Upgrade Indicates which version of which Client software can be 

upgraded, by supplying a reference that can be looked up in 
Table 2 on page xxv| Scenarios describing how to carry out 
the upgrade can be found in the relevant README files. 



Table 1. TME 10 Software Distribution, Version 3.1 .5 Platform Support 


Platform 


Server 


Client 


OS 


Version 


Scratch 


Upgrade 


Scratch 


Pristine 


Upgrade 


Windows 


2000 Professional 


Y 




Y 


Y 






2000 Server 


Y 




Y 


Y 






NT 4.0 (SP5 & 6a) 


Y 


1 


Y 


Y 


5 




NT 3.51 


Y 


1 


Y 


Y 


5 




98 






Y 




6 




95 






Y 


Y 


6 




3.11 






Y 


Y 


7 


OS/2 


3. Ox 


Y 


2 


Y 


Y 


8, 11 




4.0 


Y 


2 


Y 




8, 11 




4.5 (Warp server for 
e-business) 


Y 




Y 


Y 




AIX 


3.2.5 - 4.2.1 


Y 


3 


Y 




9 




4.3.3 


Y 


3 


Y 


Y 


9 


NetWare 


4.11 - 4.2x 


Y 


4 


Y 




10 



liable 2 on page xxvl shows the products (and versions) that can be upgraded to 
TME 10 Software Distribution, Version 3.1.5; the Reference column refers to Table 1. 
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Table 2. Products from which TME 10 Software Distribution, Version 3.1.5 can be upgraded 


Reference (see 
Table 1) 


Version installed 


CSD or Fix Pack 
installed 


TME 10 Software Distribution 


1 


3.1.3 Server for Windows NT 


XR21923 


2 


3.1.3 Server for OS/2 


XR21923 


3 


3.1.4 Server for AIX 


99/10 


4 


3.1.3 Server for NetWare 


XR21924 


5 


3.1 .3 Client for Windows NT 


XR21923 


6 


3.1 .3 Client for Windows 9x 


XR21923 


7 


3.1 .3 Client for Windows 3.1 


XR21923 


8 


3.1.3 Client for OS/2 


XR21923 


9 


3.1.4 Client for AIX 


99/10 


10 


3.1.3 Client for NetWare 


XR21924 


NetView DM/2 


11 


2.1 





Deletion of Pending Requests from Host 

In the circumstances where TME 10 Software Distribution is executing software 
distribution requests from a focal point running Tivoli NetView Distribution Manager 
(NetView DM for MVS) Release 7, the MVS focal point can now issue a request to 
delete any distribution requests that are waiting to be processed or are being processed 
at the TME 10 Software Distribution server. 

• In the case of a distribution request waiting to be processed, the original request 
will be deleted, and a report sent to the focal point confirming the deletion. 

• In the case of a distribution request that is in execution when the deletion request 
arrives, the original request will be completed, and a report sent to the MVW focal 
point confirming the successful completion of the original request; no report 
concerning the unfulfilled deletion request will be sent. 

In the case of nodes in a distribution network that are not running TME 10 Software 
Distribution, Version 3.1.5 (i.e. older versions of TME 10 Software Distribution or 
NetView DM/2) the deletion requests from the MVS focal point will be ignored. 

This functionality runs in the background with no intervention required by the operator 
of the TME 10 Software Distribution server. 

Note: As a consequence of this new functionality global names starting with 
$DELETE. SPENDING are reserved, and may not be used. 
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Changes to Statuses Reported by ‘stattg’ 

The stattg command gives details of the status of the agent at the local target. A new 
parameter has been added to the command to reveal additional information. 

In the previous releases, and when used without the new parameter, the command 
reports these statuses: 

Available Agent running and ready to process a request 

Not Available Agent not running or not accessible 

Busy Agent running a request and not available to process any other 

request. 

There are circumstances in which it is possible for the server to have in its database 
more than one workstation name for the same agent. 

For example, if a workstation has been re-defined to the server for some reason, the 
operator may have supplied a different workstation name than that originally used, but 
have used the original hostname. In this event, the agent now has the new workstation 
name, but the server has both workstation names defined; prior to this release the 
agent reported itself as being Available under both workstation names. 

With this release, by using the parameter -c, in the event that the agent is Available 
and not Busy, the command now returns the status Unknown if the hostname of the 
agent is correct but the workstation name in the status request does not match the 
workstation name of the agent. Thus, by using the -c parameter, polling both 
workstation names will allow you to identify which is the correct one, as one will return 
the status Available and the other Unknown. If the parameter is not used, the original 
functionality is maintained. 

However, before using this parameter you should consider the question of the timing of 
the stattg requests. When an agent receives a stattg request it sends the status to 
the server but is then not immediately available to satisfy another request. This means 
that a second request, received within, say, one minute of the first request, will return 
the status Not Available. If you are polling two suspect workstation names you should 
wait for this period before sending the second request. 

This also means that if you send a stattg request using the asterisk wildcard to obtain 
the status of all or a group of workstations, the results received will depend on whether 
the incorrect workstation name comes before or after the correct one in the server's 
database: 

Incorrect workstation name is polled first 

The status of the incorrect workstation name will be given as Unknown, 
while the correct workstation will give Not Available 

Correct workstation name is polled first 

The status of the correct workstation name will be given as Available while 
the incorrect workstation will give Not Available 



XXVI 



Quick Beginnings 




Changes to Statuses Reported by ‘stattg’ 



Thus, after using the asterisk wildcard with the -c parameter, you should individually 
poll each workstation name given as Not Available, waiting for approximately one 
minute before issuing each command. Workstations that are genuinely unavailable will 
report the same status as before; workstations that were unavailable while they were 
recovering from a previous stattg command will now report their true status. 

The full details of the stattg command are given in TME 10 Software Distribution 
Command Reference, TME 10 Software Distribution for NetWare Command Reference 
and TME 10 Software Distribution for AIX Reference. 
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Parti. Introduction to TME 10 Software Distribution 



This part provides you with basic information about TME 10 Software Distribution. Its 
purpose is to help you understand how to use the product effectively to perform data 
distribution and change control tasks in your network. It includes: 

• IChapter 1, “Overview of TME 10 Software Distribution” on page 3| 

• Chapter 2, “Setting Up a T ME 10 Software Di stribution Network” o n page 17 

• IChapter 3, “Preparing Software for Change Control” on page 25| 

• IChapter 4, “Using Change Control Operations” on page 31 1 

• IChapter 5, “Tracking Network Operations” on page 35 

• IChapter 6, “Using Security Functions” on page 39| 

• Chapter 7, “Finding and Using T ME 10 Software Di stribution Information” on 
page 43 
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Chapter 1. Overview of TME 10 Software Distribution 



Distributed computer systems are essential to the information technology strategies of 
many companies. The added benefits resulting from automated work processes, 
however, bring to the forefront additional concerns — the electronic distribution, 
installation, and maintenance of the software used to perform these processes. How 
can base software, applications, related configuration data, and user data files on 
hundreds, even thousands, of workstations be kept up-to-date, consistent, and 
maintained in a cost-effective and efficient way? 

This manual describes how TME 10 Software Distribution, a client/server systems 
management product, can help solve this complex problem in your enterprise. With 
TME 10 Software Distribution you can: 

• Electronically distribute and install software from a central site 

When a system software component or an application that runs on numerous 
workstations located at different sites, or even in different cities, has to be updated 
or upgraded, TME 10 Software Distribution can completely automate the 
procedure. You can prepare and package software at one workstation, send it to 
the affected target workstations, and install it automatically. 

You can facilitate the administration of software installation and maintenance on 
large numbers of heterogeneous workstations by taking advantage of 
TME 10 Software Distribution's dynamic functions. By organizing your target 
workstations into dynamic groups whose members change according to the criteria 
you establish, you can selectively administer software. You can also organize the 
content of software packages dynamically, so as to install only certain files on 
certain workstations. 

• Keep track of hardware and software installed across the network on server 
and client workstations 

TME 10 Software Distribution automatically stores a history and inventory record 
of all the hardware and software installed on each workstation in a network. This 
means that you are always aware of the configuration of all the workstations in 
your network, and consequently of the activities that need to be performed to 
ensure consistency where you require it. 

• Distribute and collect data 

System data files and user data files (such as user flat files or database exports) 
can be exchanged between the central site and target workstations and across 
workstations in the network. You can distribute data from the central site to targets 
by grouping workstations that need to receive the same files. Data distribution 
operations also provide data compression and page code translation options. 

• Manage a multiplatform environment 

You can take advantage of the benefits of TME 10 Software Distribution in a 
multiplatform environment. Workstations running OS/2, Windows 3.11, 

Windows 95, Windows 98, Windows NT, Windows 2000, or Netware can be 
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controlled from a TME 10 Software Distribution server. TME 10 Software 
Distribution servers can also interoperate with servers running different operating 
systems (such as AIX and Windows NT) in the same network. A NetView DM for 
MVS Release 7 or TME 10 Software Distribution for AIX site can also act as a 
central site for software and data distribution. 

TME 10 Software Distribution can, therefore, become a key element in ensuring the 
productivity and efficiency of your workstations and users by providing you with the 
means to: 

• Save resources, time, and money 

When you install software manually on individual workstations, the process is 
time-consuming both for those who perform the installation and for those who work 
at the workstation. When you use TME 10 Software Distribution to automate 
software management, one person (the administrator) from one workstation can 
update thousands of computers, and plan the installation for a convenient time 
when it does not interfere with anyone's work schedule. What's more, you can 
automatically create backups of old software, which can immediately be reinstalled 
should an installation be unsuccessful. 

• Improve efficiency 

Controlling all the software installed on all the workstations means ensuring 
constant compatibility and consistency across your network. No longer will 
different versions of software be run on different workstations. Unpleasant 
surprises of incompatibility between workstations will no longer be a common 
occurrence. 

In this book the functions provided by the product are referred to as software 
distribution and change control. 1 The same term is used across the TME 10 Software 
Distribution family of products. 



Using TME 10 Software Distribution in a Network 

You can use TME 10 Software Distribution functions in many different network 
topologies, which differ greatly in complexity. In the simplest networks, 

TME 10 Software Distribution is installed on a workstation that is referred to as the 
network distribution server (server). The other workstations in the network become 
distribution clients (clients) that can work in conjunction with a TME 10 Software 
Distribution server. 



Figure 



1 on page 5| shows a simple network with a server and its clients. Clients 

The set of local clients, together 



controlled by a server are referred to as local targets. 
with the server that controls them, is known as a change control domain. 



1 In TME 10 Software Distribution terminology, change control is at times referred to as change management. 
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Software Distribution 
Client 



Figure 1. A Single-server TME 10 Software Distribution network 

Change control and distribution activity in a network is usually initiated from a server. 
However, if a client is configured with the necessary authorizations, it can be an active 
client, meaning that it can initiate operations on other clients in the network. A passive 
client can only have operations performed on it. 

More complex networks can combine interconn ected domains. Server s and clients in 
other domains are referred to as remote fargefs Pngure 2 on page 6l shows a network 
with two domains. 

In the figure, SERVER01 can perform data distribution, but not change control, on the 
clients in DOMAIN02. 
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Figure 2. Interconnected domains 

Servers can be controlled from one or more central NetView DM for MVS or 
TME 10 Software Distribution for AIX sites that maintain a total picture of the entire 
change control network F Figure 3 on page 71 shows a NetView DM for MVS system 
managing multiple TME 10 Software Distribution domains, and lFiqure 4 on page 8| 
shows a similar configuration with a TME 10 Software Distribution for AIX system as 
the central site. 
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Networks can also include remote connections to systems running any of the products 
in the TME 10 Software Distribution/NetView DM for MVS family. 



TME 10 Software Distribution Users 

Three default classes of users are defined in a TME 10 Software Distribution system: 

• Administrator 

• Builder 

• User 

Change Control Administrator 

A TME 10 Software Distribution administrator is responsible for ensuring that software 
packages are installed across the network, kept up-to-date, and removed when no 
longer required. Administrators use TME 10 Software Distribution typically to: 

• Define the targets that a server can communicate with, both in its own domain and 
in remote domains 

• Define the users of the product and their authorizations 

• Define target, user, and software access authorizations 

• Initiate the distribution of data files 

• Initiate the managed installation of software packages by the server on client 
workstations 

• Change the software installed on workstations across the network 

• View the status of the software packages already installed on client workstations 

• Track the status of change control and distribution operations across a network 

• Run applications on remote, unattended workstations across the network 

In addition to using a server workstation, the administrator can carry out software 
installation and data distribution functions from any client workstation that is configured 
in user-interface-only (Ul only) mode. A Ul only client provides an interface to access 
the server and the capability to initiate change control actions across targets in the 
network, but no change control operations can be directed to it. 



Builder 

The builder is typically a programmer who is authorized by the change control 
administrator to prepare the software to be installed using TME 10 Software 
Distribution. Each separate application or system software product must be prepared 
as a package suitable for installation by the client program it is destined for. 

The builder uses either a server or a client workstation as a preparation site for 
software. The builder can also use a single node as a preparation site. 
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User 

The user is anyone who uses the services of TME 10 Software Distribution on a client 
workstation to: 

• Perform change control and distribution functions on their own or on other 
workstations in a network 

• Distribute data files across the network to any workstation with a client product 
installed on it. 

User Profiles 

User profiles that correspond to these descriptions are installed automatically with the 
product. However, administrators of the system can create customized profiles that 
authorize product users to perform any combination of tasks. 



TME 10 Software Distribution User Interfaces 

You can choose either one of two user interfaces to work with TME 10 Software 
Distribution: 

• Graphical user interface 

• Command line interface 

Graphical User Interface 

The graphical interface provides access to all TME 10 Software Distribution functions. 

It can be started even if the product is not active, in which case you can perform only a 
limited number of operations (for example, you can configure new targets but you 
cannot initiate change control operations). 

The graphical interface presents lists of objects (such as a list of files) that you select 
using the mouse or cursor keys. After you select the items you want to work with, 
select an action to perform on them. 

The graphical user interface has three components: 

• Software distribution 

• Message log 

• Software preparation 

The software preparation interface has two components: 

• Generic software 

• CID software 
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Software distribution Interface 

This interface is divided logically into main windows from which you access functions. 
These windows are: 

Catalog 

This window contains a list of all files currently in the server catalog, a database 
that contains records of all files maintained by the TME 10 Software Distribution 
system. From this window, you can choose options that enable you to: 

• Perform distributions of software objects and data files 

• Initiate change control activities 

• View change control history records 

• Start and stop the product 

Targets 

Select this window to view a list of the targets that have been set up. From this 
window you can: 

• Create new targets and group targets together 

• Modify details about existing targets 

• Delete existing targets 

• View change control history of targets 

• Alter the server configuration 

Message Log 

This window displays a list of all messages that have been logged. Access it to: 

• View messages 

• Display help information for any message 

• Save the messages to a file 

Help 

This window can be used as an alternative way to access help information, which 
can be displayed from any dialog window. 

Local Queues 

Select this window to display a list of the queues that route requests to clients in a 
domain. From this window, you can: 

• View the contents of queues 

• Perform operations on queues 

Remote Queues 

This window displays a list of the queues that route files to remote domains in a 
network. From this window, you can: 

• View the contents of queues 

• Perform operations on queues 

This window can be accessed only if the communication option is installed on your 
system. 
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Requests 

Select this window to track and control the progress of requests that have been 
submitted to TME 10 Software Distribution. From this window, you can: 

• List the status of requests at the request, domain, and target levels. 

• Hold, release, reschedule, restart, and delete requests. You can also erase 
requests from the product database. 

From each of these windows, you can access any of the other main windows. 

Message Log Interface 

You can use this interface to display a list of all the messages that have been logged. 
Access it to: 

• View messages 

• Display help information for any message 

• Save the messages to a file 

Software Preparation Interface 

This interface contains a software preparation component and a CID preparation 
component. 

The first window that appears in the software preparation interface is the Software 
Preparation window. From this window you can choose whether you want to prepare 
generic software or CID software. 

If you choose generic software, the first window that appears is the Software Object 
Profiles window. From this window you can access other windows to perform software 
preparation functions. These windows are: 

Catalog 

From this window you can perform the following tasks: 

• See a list of existing software objects in the catalog 

• Group the software objects according to criteria you specify 

• Browse the contents of a software object in the catalog 

Software profile - create another 

From this window you can perform the following tasks: 

• Create completely new software objects 

• Create new software object profiles from existing profiles 

• Create new software objects, using DiskCamera 

• Create new software objects from the catalog 



The DiskCamera function available in the graphical interface facilitates the 
creation of software objects by taking pictures of a hard disk before and after a 
software product is installed on it. The two pictures are compared by DiskCamera, 
which generates a software object that includes all the new files the comparison 
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found on the drive as well as any changes that were made to system files as a 
result of the installation. 

If you choose CID software, the first window that appears is the CID Software 
Preparation window. From this window you can perform the following tasks: 

• Set up a code server for images of CID-enabled products and response files 

• Upload software images to the code server 

• Prepare a CID-enabled product for distribution, generating a response file 

• Prepare a CID-enabled product for distribution, using an existing response file 

Command Line Interface 

The command line interface is composed of commands that you issue from a command 
prompt. A command is a string of letters with corresponding parameters that you use 
to make specific requests. Expert users often prefer using the command line as an 
alternative to the graphical interface because it saves time. 

You can perform all TME 10 Software Distribution operations using this interface. For 
example, to install the software object called test.file.ref.1.1.2 on a group of targets 
called groupone at 10:00 on March 14, 2000, you would use this line command: 

nvdm Inst test.file.ref.1.1.2 -w groupone -d “14/3/2000” -t “10:00” 

Line commands and their syntax are documented in the online Command Reference 
file. 

Starting and Stopping the Command Line Interface 

You do not have to enter any particular commands to start the command line interface. 
Simply enter commands from a prompt. Each specific command must be preceded by 
nvdm. For example, to display a list of targets defined in your network, at the NVDM > 
prompt, enter: 

1 stg * 



Starting TME 10 Software Distribution 

You can start TME 10 Software Distribution during the normal startup processing of 
your system. You can also start and stop the product's components from the desktop, 
the graphical user interface, or the command line. 

To start TME 10 Software Distribution from the desktop, click on the TME 10 Software 
Distribution icon. The TME 10 Software Distribution folder is displayed, as shown in 
Fi gure 5 on page 14 
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Figure 5. TME 10 Software Distribution for OS/2 folder 

Then in the TME 10 Software Distribution folder, click on Start Distribution Server or 
Start Distribution Client. 

To start TME 10 Software Distribution from the graphical user interface: 

1. In the Catalog window in the software distribution interface, select Engine from the 
menu bar and select Start the system from the pull-down menu. 

A window with the message The system has been started successful ly is 
displayed. 

2. Select OK to return to the Catalog window. 

To start TME 10 Software Distribution from the command line interface, enter the 
following command from a command prompt: 

nvdm start 

Starting the Graphical Interfaces 

You can start the graphical interfaces from the desktop or from the command line. 

To start the graphical interfaces from the desktop, click on the TME 10 Software 
Distribution icon. Then in the TME 10 Software Distribution folder, click on the icon for 

Software Distribution, Software Preparation, or Message Log. 

To start the graphical interfaces from the command line, complete the following steps: 

1. Enter one of the following commands from the BIN subdirectory in the directory 
where the product is installed: 
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• To start the software distribution interface, enter: 
nvdmgi 

• To start the message log interface, enter: nvdmgi lg 

• To start the software and CID software preparation interface, enter: nvdmgi pc 

The TME 10 Software Distribution Logo window appears. 

2. Select the OK push button to continue (If you do not select it, the Logo window will 
disappear after 10 seconds.). The TME 10 Software Distribution Logon window 
appears, as shown in Figure 6. 




Figure 6. Logging on to TME 10 Software Distribution 



3. Enter your User ID, followed by your Password if you have one. 
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4. In the Server Name field enter the name of the server you want to be connected to 
for this work session. If a list of servers is displayed, select a server from the list. 

5. Select the Logon push button. The Catalog window is displayed. 

Note that starting the graphical interface does not automatically start TME 10 Software 
Distribution. If the product is not active, follo w the instructions given in [“Starting] 

TME 10 Software Distribution” on page 13 



Stopping TME 10 Software Distribution 

To stop the product from the desktop, click on Stop Distribution Server or Stop 
Distribution Client in the product folder. 

To stop the product from the graphical interface: 

1. In the Catalog window in the software distribution interface, select Engine from the 
menu bar and select Stop the system from the pull-down menu. 

2. Select OK to return to the Catalog window. 

The graphical interface stops when all the main windows have been closed. To close a 
window, do one of the following: 

• Press Alt+F4 

• Select Close from the System menu 

• Double-click on the System Menu icon 

• Select Close all from the Windows menu to close all the windows and stop the 
graphical interface. 

To stop TME 10 Software Distribution from the command line interface, enter the 
following command from a command prompt: 

nvdm stop 
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Chapter 2. Setting Up a TME 10 Software Distribution Network 



This chapter provides information to help you set up workstations in your network as 
TME 10 Software Distribution targets, and to configure their communication links. It 
also describes the functions you can use to keep track of the hardware configuration of 
the workstations in your network. 



Types of Target in a TME 10 Software Distribution Network 

Targets are defined in a TME 10 Software Distribution network according to the role 
they are to perform and how they are to perform that role (specified as target mode). 
This section describes the various roles you can assign to targets. 

Targets are either local or remote, depending on their location in the network. A target 
that is in the same domain as the target communicating with it is a local target. When 
targets perform data distribution across domains in multidomain networks, they are 
remote targets. 



Types of Local Target that Can Be Defined 

You can define local targets to perform one of the roles described in the following 
sections. 



Server 

Servers contain the catalog where software objects and data files, as well as change 
control history records, are stored. They also contain the configuration information for 
all the targets they can communicate with, be they local or remote. Whenever a client 
communicates with another target, the communication is routed through its server. 

A server can initiate change control and distribution operations on targets in their own 
domain. They can also perform distribution operations on remote targets. 

Role Target Type Target Mode 

Initiate change control on targets Server Push 

Initiate distribution on targets Server Push 

Client 

Client targets work in conjunction with a server, and must have a TME 10 Software 
Distribution Client product installed. A local client can: 

• Be the object of change control operations initiated by a server, when configured in 
push mode 

• Distribute data files (send, retrieve, and delete them) to other clients in its domain 

• Initiate change control operations on itself, using any software available to it from 
the server catalog, when configured in pull mode 
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Types of Local Target that Can Be Defined 



• Build software objects and store them in the server catalog 

• View information about the software installed on its workstation, as well as 
information about the other clients and software available in the network 

• Catalog and uncatalog data files 

The following modes can be defined for a client target: 



Role 


Target Type 


Target Mode 


Server/other client initiates change 
control 


Client 


Push 


Initiates change control on self 


Client 


Pull 


Prepare software objects 


Client 


Push or pull 


Send, retrieve, delete data files 


Client 


Push or pull 



Mobile Client 

Mobile clients are local targets on which it is possible to do change management 
operations without connection to a server. Mobile clients must be installed with the 
Mobile Client component. 

You connect a mobile client using the GUI or the connect command on the command 
line. With this command you can also establish the time when the connection window 
is opened, the connection duration, and a recursive daily connection. You disconnect a 
mobile client using the GUI or the disconnect command on the command line. With 
this command you can also stop the established recursive daily connection from the 
client to the server. See the helps or the Command Reference for more details. 

Because mobile clients are not always connected with a server whose catalog they can 
access, they have their own local catalog. Once a mobile client's catalog has been 
updated, the client can perform the following operations locally: 

• Install software and software changes 

• Remove software 

• Accept changes to software 

• Activate pending changes on your workstation 

• Uninstall software packages and software changes, along with any updates or fixes 
applied 

• Catalog and uncatalog files in the local catalog 

• Import software objects from external devices 

• View software object information 

• View and purge pending requests 



Mobile clients are not forced to work locally; they can connect to a server and function 



as non-mobile clients, performing all the tasks described in |“Client” on page 17 
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Types of Remote Target that Can Be Defined 



Mobile clients can also function as fully disconnected clients, meaning that they never 
connect to a server. They update their local catalog with software objects manually 
from external media (CD-ROMs, tapes, diskettes), and then perform change control on 
themselves. Change control status information stored in the server catalog for fully 
disconnected mobile clients can then be updated manually, using the updcm 
command. A fully disconnected client must set the FULLY DISCONNECTED keyword 
in its base configuration file to YES. 

Define the following attributes for mobile clients: 

Role Target Type Target Mode 

Work as mobile client Mobile Push or pull 

Work as fully disconnected mobile client Client Disconnected 



User Interface Only Client 

These targets can be used only to run the TME 10 Software Distribution user 
interfaces. This type of target is useful when you have an environment with more than 
one server. It allows an administrator to access all servers from the same target, either 
to perform administrative tasks or to schedule operations. 

A workstation configured in this manner is used to initiate change control on other 
targets, or to request distributions to and from the server. User interface only targets 
cannot be the object of change control instructions from the same server they are 
defined as a user interface only target for. 

Define the following attributes for this type of target: 

Role Target Type Target Mode 

User interfaces at server Ul only None 



Types of Remote Target that Can Be Defined 

Remote targets can perform a greater variety of roles, in networks with more complex 
topologies. The possibilities are described in the following sections. 



Server 

Servers contain the catalog where software objects and data files, as well as change 
control history records, are stored. They also contain the configuration information for 
all the targets they can communicate with, be they local or remote. Whenever a client 
communicates with another target, the communication is routed through its server. 

A server can initiate change control and distribution operations on targets in their own 
domain. They can also perform distribution operations on remote targets. 
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Role Target Type Target Mode 

Initiate change control on targets Server Push 

Initiate distribution on targets Server Push 



Intermediate Node 

Remote servers can act as intermediate nodes, whose task is to fan out requests to 
downstream nodes. The fan-out operation creates multiple copies of the same object 
to be distributed to a number of, or a group of, targets. 

Using intermediate nodes is often an efficient and cheaper way of distributing large 
quantities of data to numerous destination targets, because they eliminate the need for 
a direct connection between the target that originates an operation and the targets 
addressed by the operation. 

Role Target Type Target Mode 

Fan-out change control requests Server Push 



Single Node 

You can use single-node targets as preparation sites for software. 

Role Target Type Target Mode 

Act as preparation site Single Push 



Defining Client Targets Automatically 

You do not have to configure all client targets in a network individually from a server. 
You can set up your network so that they are configured automatically, or 
autoregistered, the first time a client target connects to a server. For autoregistration to 
take place, the AUTOMATIC TARGET REGISTRATION keyword in a server's base 
configuration file must be set to YES, and the TARGET ADDRESS and TARGET 
MODE keywords must be specified in the client base configuration file. See 



Chapter 10, “Editing the Base Configuration File” on page 73 f or a description of the 



server base configuration file, and the Installation and Configuration manual for the 
client base configuration files. 



When a client is automatically configured, its address and mode are inserted in its 
server database. Any other parameters for the client target must be specified manually 
using the graphical interface or the command line interface. 
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Platforms Supported in a TME 10 Software Distribution Network 

TME 10 Software Distribution networks can include workstations that are connected 
across local and remote links. As a rule, local links connect servers to their clients and 
remote links connect servers to other servers in different domains. 

Client Platforms Supported 

You can connect a server to clients that run any of the following operating systems, 
provided they have the corresponding TME 10 Software Distribution Client product 
installed: 



Table 3. Client Platforms Supported by TME 10 Software Distribution 


Platform 


Product 


AIX/6000® 


TME 10 Software Distribution for AIX Client 


OS/2 


TME 10 Software Distribution for OS/2 Client 


Windows 2000 


TME 10 Software Distribution for Windows 2000 Client 


Windows NT 


TME 10 Software Distribution for Windows NT Client 


Windows 95 & 98 


TME 10 Software Distribution for Windows 9x Client 


Windows 3.11 


TME 10 Software Distribution for Windows 3.11 Client 


NetWare 


TME 10 Software Distribution Client for NetWare 



Remote Platforms Supported 

You can connect a server to workstations in other domains. As described in [“Types of! 



Remote Target that Can Be D efined” on page 19| these workstations can be configured 



as: 



• Servers configured as managers or focal points 

• Intermediate nodes 

• Single nodes 

Remote workstations can run any of the following operating systems, provided they 
have the corresponding TME 10 Software Distribution product installed. Table 4 lists 
supported platforms and counterpart products, and the roles they perform within the 
network. 



Table 4 (Page 1 of 2). Remote Platforms Supported by TME 10 Software Distribution 


Platform 


Product 


Role 


AIX/6000 


TME 10 Software Distribution for AIX 


Manager 
Focal point 
Intermediate node 

Remote server (data distribution only) 


OS/2 


TME 10 Software Distribution for OS/2 


Remote server (data distribution only) 
Intermediate node 
Single node 
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Table 4 (Page 2 of 2). Remote Platforms Supported by TME 10 Software Distribution 


Platform 


Product 


Role 


Windows 2000 


TME 10 Software Distribution for Windows 2000 


Remote server (data distribution only) 
Intermediate node 
Single node 


Windows NT 


TME 10 Software Distribution for Windows NT 


Remote server (data distribution only) 
Intermediate node 
Single node 


NetWare 


TME 10 Software Distribution for NetWare 


Remote server (data distribution only) 
Intermediate node 
Single node 


MVS 


NetView DM for MVS Release 7 


Manager 
Focal point 



Communication Protocols that Can Be Used to Link Nodes 

Clients, servers, and TME 10 Software Distribution/NetView DM for MVS family 
products can be linked in a network using different transmission protocols: 

NetBIOS, TCP/IP, IPX, or APPC 

To connect a server and its clients. 

SNA/DS across APPC 

You can configure SNA/DS across APPC for remote server/server connections to 
another OS/2 server, an AIX server, a NetWare server, or a Windows NT server 
acting as an intermediate node. You can also connect to a NetView DM for MVS 
focal point over APPC. 

STS across APPC, TCP /IP, NetBIOS, or IPX 

STS is the acronym for the term server-to-server. This is an internal 
TME 10 Software Distribution transport mechanism that can be configured in 
networks connected: 

• Over APPC, TCP/IP, NetBIOS, or IPX for remote server/server connections to 
an OS/2 server or an OS/2 client 

• Over TCP/IP, NetBIOS, or IPX for remote server/server connections to a 
Windows NT server 

• Over APPC or TCP/IP for remote server/server connections to an AIX server 

• Over IPX or TCP/IP for remote server/server connections to a NetWare server 

STS communication offers better performance for many transmission operations, 
as well as these additional functions: 

• You can send, retrieve, and delete data files that are not stored in the catalog, 
called uncataloged files. Uncataloged data files can also be used as 
procedures to be executed at targets. 

• You can authorize data files so that they can be executed at remote targets. 
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Grouping Targets to Facilitate Change Control Operations 



|“Communication Protocols” on page 50l provides full details of the communications 
protocols that can be used from a server with TME 10 Software Distribution, Version 
3.1.5 for OS/2 installed to any client or server with which TME 10 Software Distribution 
can communicate. 



How Grouping Targets Can Facilitate Change Control Operations 

Grouping targets into homogeneous units can be a useful aid in organizing and 
scheduling change control operations, especially when you are dealing with an 
extensive network. When you request change control and distribution operations for a 
group, the operation is performed on all the targets included in it. 

Groups can include up to 1000 local and remote targets, whose mode can be either 
push, pull, manager, or focal. What's more, you can define static groups, whose 
members are always the same, or dynamic groups, whose members change according 
to criteria you define for populating the group. 

A dynamic group can contain both static and dynamic members. The static members 
are always included in the group, while the dynamic members change according to the 
filters and rules you establish for populating the group. Filters allow you to define the 
members of a group according to: 

• Target names 

• Target types (client, mobile, server, single, Ul only) 

• Target modes (push, pull, focal point, manager) 

• Target operating systems 

• Target access keys 

Rules are statements that specify the logical relationship between values you specify 
for any of these tokens: 

Target installation parameters 

Tokens substituted during the installation process. Installation parameters usually 
correspond to directory and path names. 

Hardware tokens 

Hardware requirements specified when targets are defined individually to the 
system. 

Change management statuses 

The statuses that form part of the history records stored in the catalog for software 
objects and targets. 

The following examples give you an idea of how you can use static and dynamic 
groups to your advantage: 

• If you must send DATA_A1 to all the targets in EuroTravel's branch offices every 
week, you can create a static group called BRANCHES, that holds all the targets the 
file must be sent to. Then every week you simply have to send DATA_A1 to 
BRANCHES. 



Chapter 2. Setting Up a TME 10 Software Distribution Network 23 



The Number of Targets a Network Can Include 



• Suppose you have to install a new version of a word processor only on those 
targets in EuroT ravel offices where the word processor is already installed. You 
can create a dynamic group called HAVE_W0RDPR0C; the rule used to populate the 
group would state “include those targets whose change management status is 
equal to install for the EURO. WORDPROC. REF. 0 software object”. Then install the word 
processor on HAVE_W0RDPR0C. 



The Number of Targets a Network Can Include 

When you are planning the topology of a network, you must know how many 
workstations TME 10 Software Distribution can support, as shown in Table 5. 



Table 5. Connection and Performance Considerations 


Maximum number of clients per server 


1000 


Maximum number of concurrently active clients in a domain 


50 
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Chapter 3. Preparing Software for Change Control 



This chapter describes what you must do to the software package so that it can be 
used in change control operations. 



Software Objects 

Changes to software on a workstation are distributed in packages that contain software 
files together with instructions about how they are to be installed. These packages are 
called software objects. (Software objects are also called change files.) 

Contents of a Software Object 

The main information included in software objects is: 

• Specifications of the files to be included in the package and their location. 

• Specifications of the location of files stored in directories at a remote site. These 
remote directories are mounted from a target when an installation or other change 
control operation is performed. When you use this remote source method, you can 
make use of file servers in your network and create smaller software objects that 
occupy minimum disk space at both the server and clients. 

• Specifications of directories to be created or deleted at the target workstation. 

• Response files (for pa ckages with CID conformance only; see |“CID Softwarel 
Objects” on page 27j . 

• Information about hardware and software prerequisites and corequisites, including 
disk storage space requirements. TME 10 Software Distribution checks for the 
presence of prerequisite and corequisite software and the amount of disk space 
available for a package before attempting to install it. 

Software objects that include all the prerequisite files required for an installation 
can be generated automatically. 

• Scripts or programs that tailor the installation and other operations to be executed 
on the target. 

• A description of each product or file that is included in the software object. This 
information is convenient for tracing software object history. 

• Compression options and packing instructions to apply if transmitting or storing the 
software object in compressed format. You can also specify if each file in the 
software object is to be compressed at build time and decompressed at install time. 
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Types of Software Object 

You create different types of software object depending on whether you have to install 
new software, update existing software, or apply fixes to existing software at targets. 
These types of software object are referred to by the following change names : 



Refresh (REF) 



Update (UPD) 



Fix (FIX) 



Software objects that contain a complete new copy of the 
software or data item being changed to a new level, release, or 
version. 

Software objects that contain an update to a component and are 
installed on top of the original. Updates change the level of the 
component ID. To install an update, you must first install a 
refresh software object as not removable. 

Software objects that contain a fix for an existing component and 
are installed on top of the original or an update. Fixes do not 
change the level of the component ID. To install a fix, you must 
first install a refresh software object as not removable. 



Naming Software Objects 

The names you assign to software objects follow the convention for labels (also called 
global names). Using labels ensures that each software object is identified uniquely. A 
label consists of three main elements: 

• The name of the component or software package 

• The type of change to the component or software package (refresh, update, or fix) 

• The level of change to the component or software package. 



The following conventions apply when you create a label: 

• The name can have from 2 to 10 parts 

• Parts must be separated by a period 

• The label cannot start or end with a period 

• Each part cannot exceed 16 characters 

• The label, including periods, cannot exceed 64 characters 

• Numbers, uppercase letters, and the characters $, #, @, and _ can be used in 
labels. 

• Global names starting with $DELETE. SPENDING are reserved, and may not be 
used. 



Software Object Platform Dependencies 

A software object's format must be compatible with the method used at a target to 
install software. When builders create software objects, they must specify the type of 
installation procedure that will be used, which can be: 

• Generic 
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• CID 

The software installation methods supported by TME 10 Software Distribution depend 
on the type of workstation where the installation is being performed. All the methods 
described below require that software objects be stored at the server. A software 
object can, however, contain the specification of software files to be accessed remotely 
for the actual installation process. This applies whether the software installation 
process is initiated from a server or from an active client workstation. 

Generic Software Objects 

Generic software objects are created when the generic installation method is used. It is 
a robust all-purpose method that can be used to install on targets on all supported 
platforms. This method replicates the files contained in a software package. 

CID Software Objects 

The configuration, installation, and distribution (CID) method can be used to prepare 
software for clients on all supported platforms. 

Use CID software objects for: 

• IBM products, such as Database Server or Communications Server 

• Other products that conform to the CID standards and that are extensively affected 
by the target workstation hardware and software configurations 

The CID method of installation uses redirection of code images from files installed on 
the hard disk of any workstation within the same domain as the target workstation. The 
code images are not required to be stored on the server. Response files that allow for 
unattended installation are prepared at the preparation site. 

The redirection of code images can be performed by the Network File System (NFS) or 
by the IBM File Server/Requester. The method used depends on the workstation from 
which the code images are to be redirected. 



The TME 10 Software Distribution Catalog 

The TME 10 Software Distribution catalog is a change control history database 
maintained on the server. The catalog contains a list of the names of all software 
objects and data files that are available to authorized users of client workstations 
across the network. It also lists the status of software objects at each workstation. 

Items in catalogs are identified using labels so that each is unique across a multiserver, 
multidomain environment. Parts of the software object's label can also be used to 
identify the software platform a target runs under. 

Items can be added to or removed from the catalog by any authorized user. The 
objects named in the catalog can reside on the server or on any of the clients in the 
domain. 
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The catalog can be used by all the clients associated with the server on a single-server 
network to check the availability of new software packages, updates to existing software 
packages, and data files that are available for general distribution to authorized client 
workstations. 



Installing the Same Software Object on Different Workstations 

You can create software objects that are static, meaning that the installations they 
trigger are always the same regardless of the workstations they are installed on, or 
dynamic, meaning that the installation procedures are different depending on the 
configuration of the workstations they are performed on. 

Dynamic software objects are defined by expressing conditions that must be satisfied 
before a corresponding operation takes place. You can specify dynamic conditions in 
relation to: 

• The hardware installed on a workstation 

• The software installed on a workstation 

• The operating system running on a workstation 

• The directory the software is to be installed in, or already resides in if the software 
is being uninstalled or removed 

• Procedures to be run at the workstation before or after operations are performed. 



For example, you can take advantage of the flexibility offered by dynamic software 
objects to: 

• Install software on two types of workstation: small machines or big machines. To 
do so you would include these conditions: 

DYNAMIC SECTION: bi g_machi ne 

CONDITION: DRIVE_SIZE >= 180M 

PRE-INSTALL: <product_di rectory>\pre-instal 1 



DYNAMIC SECTION: 
CONDITION: 
PRE-INSTALL: 



smal ljnachi ne 

DRI VE_S I ZE < 180M 

<product_di rectory>\pre-i nstal 1 -smal 1 



OBJECT: 

DYNAMIC SECTION: 
SOURCE NAME: 
TYPE: 

ACTION: 



smal Ijnachine 

<product_di rectory>\f i 1 e_smal 1 
FILE 
COPY 
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Installing the Same Software Object on Different Workstations 




• Mount different remote directories for installations on workstations with different 




operating systems: one for UNIX-based operating systems, one for Intel-based 




operating systems, and one for Windows NT. To do so you would include these 




dynamic sections: 






GLOBAL NAME: 


user4.exit4.ref.l 




CHANGE FILE TYPE: 


GEN 




COMPRESSION TYPE: 


LZW 




REBOOT REQUIRED: 


NO 




DEFAULT TOKEN: 


SRCINST (AIX) = /mnt/ 




DEFAULT TOKEN: 


TRGINST (AIX) = /instago/ 




DEFAULT TOKEN: 


TRGINST (ALL) = C:\INSTAG0\ 




DEFAULT TOKEN: 


SRCINST (ALL) = z:\ 




REMOVABLE: 


YES 




ACTIVABLE: 


YES 




INTERACTIVE: 


NO 




AUTHORIZE: 


NONE 




SW HISTORY RESET: 


NO 




INSTALLATION DURATION: 


00:00:00 




COST: 


0 




PACK FILES: 


NO 




SECURE PACKAGE: 


NO 




DYNAMIC SECTION: intel mount 






CONDITION: OPS. OPERATING SYSTEM=0S/2 




REMOTE DIRECTORY: 






SERVER NAME: 


os2server domntst 




EXPORTED DIRECTORY: 


c:\usrdir 




MOUNTED FILE SYSTEM: 


z : 




MOUNT OPTIONS: 


al stst 




DYNAMIC SECTION: unix mount 






CONDITION: OPS. OPERATING SYSTEM=AIX 




REMOTE DIRECTORY: 






SERVER NAME: 


pwpcl 




EXPORTED DIRECTORY: 


/ al f i /newbl d/cl i ent_2 




MOUNTED FILE SYSTEM: 


/mnt 




PREREQ COMMAND: 


Is -1 / > /I s.out 




DYNAMIC SECTION: nt mount 






CONDITION: OPS. OPERATING SYSTEM=WINDOWS NT 




REMOTE DIRECTORY: 






SERVER NAME: 


650 




EXPORTED DIRECTORY: 


source. nt 




MOUNTED FILE SYSTEM: 


L: 




MOUNT OPTIONS: 


/user:guest 




PREREQ COMMAND: 


dir D:\ > D:\dir.out 




OBJECT: 






DYNAMIC SECTION: 


i nteljnount 




SOURCE NAME: 


c:\usrdir 




SOURCE NAME AT INSTALL: 


$ (SRCINST) fname.txt 
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TARGET NAME: 

TYPE: 

ACTION: 

INCLUDE SUBDIRS: 

OBJECT: 

DYNAMIC SECTION: 

SOURCE NAME: 

SOURCE NAME AT INSTALL: 
TARGET NAME: 

TYPE: 

ACTION: 

INCLUDE SUBDIRS: 

OBJECT: 

DYNAMIC SECTION: 

SOURCE NAME: 

SOURCE NAME AT INSTALL: 
TARGET NAME: 

TYPE: 

ACTION: 

INCLUDE SUBDIRS: 



$ (TRGINST) fname. txt 
REMOTE_FILE 
COPY 
NO 



unix_mount 

/mntl/cl i ent_2/fndswi nv 

$ (SRCINST) fndswi nv 

$ (TRGINST) fndswi nv 

REMOTE_FILE 

COPY 

NO 



ntjnount 

/mntl/cl i ent_2/fndswi nv 

$( SRC INST) NTREF.BAT 

$ (TRGINST) NTREF.BAT 

REMOTE_FILE 

COPY 

NO 



Software Preparation Interfaces 

You can use one of three methods to prepare software objects: 

Graphical interface preparation notebook 

The graphical interface allows you to create both basic software objects that 
simply contain software files and any scripts or procedures, and advanced 
software objects that include additional functions such as dynamic conditions and 
remote directory sources. 

Graphical interface DiskCamera function 

The DiskCamera function available in the graphical interface facilitates the creation 
of software objects by “taking pictures” of a hard disk before and after a software 
product is installed on it. The two pictures are compared by DiskCamera, which 
generates a software object that includes all new files the comparison found on the 
drive as well as any changes that were made to system files as a result of the 
installation. 

Command line interface 

You create software objects using the command line interface by first creating an 
ASCII software object profile and then issuing the build command against it. 
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Chapter 4. Using Change Control Operations 



This chapter describes change control operations made available through 
TME 10 Software Distribution, and how to schedule their use in your network. 



Change Control Operations 

TME 10 Software Distribution offers you a fully automated method for distributing and 
installing software. You can use it to schedule and install software and updates to 
previously installed software, as well as to uninstall updates and restore the software to 
its previous state. TME 10 Software Distribution performs the following functions in a 
network: 

• Installs software packages on workstations 

A new software package can be installed automatically, with no user intervention, 
on all workstations in the network. Installed software is available for use 
immediately after a client is restarted. This is done using the install function for a 
refresh software object. 

Software changes can also be distributed over a network so that software files are 
either updated or removed automatically on all workstations on which the software 
was originally installed. An installation request can also check that prerequisite 
and corequisite software is present on a target before installing software packages. 

• Applies updates to a current software level 

When a new level of a software product is released, it can be applied to existing 
software as an update. 

• Applies fixes to software 

When fixes to installed software are released, these can be applied to all existing 
installed copies. This is done using the install function for a fix software object. 

• Installs software from remote workstations 

Software files to be installed can be stored in a remote directory that is mounted at 
a target during the installation process. When you do not mount remote directories 
for installations, files are sent to a target, stored in the work area during installation, 
and then deleted when the installation is complete. This means that a target must 
have double the amount of disk space required by a product. 

When you take advantage of the remote mount capabilities offered by 
TME 10 Software Distribution, you can redirect installations: 

- To directories located on a server. 

You do so by specifying the name of the directory to be exported and the 
options required for the remote mount using specific shared tokens 
(SERVERREPOS, SEVEREXPOP, REMOTEREPOS, REMREPMNTOP). You specify them 
when you define target parameters using the addpm command. 

- To directories located on another workstation in the domain. 
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You do so by specifying the directory to be exported and the remote mount 
information when you build a software object using either the graphical 
interface or the bid command. 

• Installs software on unattended workstations 

You can use TME 10 Software Distribution to send a command to a client 
workstation to install, update, or delete changes to its software while it is 
unattended and has no user logged on. 

• Rolls back (backs up) to the previous level of software 

An installation operation can also include a request to back up the version of 
software currently installed on a workstation. Any files deleted or modified by the 
installation process are automatically saved, and if the installation is unsuccessful, 
the previous version can be restored, or rolled back. The current level of the 
application must be installed with the removable option in order for the remove 
function to perform a roll-back. 

• Makes changes permanent 

If the software package was installed on one or a group of clients with the backup 
option, a single accept request to make this version permanent can be submitted to 
all the clients. After software has been accepted, the previous version or level 
cannot be restored. 

• Uninstalls one or more software packages installed previously by 
TME 10 Software Distribution 

The uninstall function removes, in a single operation, selected software packages 
from one or more clients. The software packages must have been installed 
originally by TME 10 Software Distribution. 

• Activates software on one or a group of workstations 

The activate function restarts one or a group of workstations in a single operation 
after TME 10 Software Distribution has been used to install software packages on 
them. 



Scheduling Change Control Operations in the Network 

You can schedule the distribution of data and software and change control operations 
to occur at specific times, according to when it is both necessary and most convenient. 
Using appropriate schedules you can achieve network-wide synchronization of the 
installation of particular software. The scheduling facilities provided by 
TME 10 Software Distribution are flexible, and provide you with alternative methods to 
express when and how often operations should take place. You can: 

• Specify change control windows for targets 

Each client workstation that is a target for software installation can be configured 
with a change control time window, a period of time during which installation of the 
software can take place. Installation of software that is scheduled for times outside 
the change control window for a client workstation is suspended until the change 
control window is open. 
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Distributing Data Files 



You specify change control windows when you define targets to the network. 

• Specify origin or destination operation times 

You can schedule operation times for either the workstation where the operation 
originates, or the workstation where the operation is to take place. This makes it 
possible to schedule requests that are to take place in time zones different from 
the zone of the origin workstation. You can also schedule a period of time before 
and after which an operation cannot take place. 

• Specify high-priority operations 

Change control operations that are urgent can be transmitted as high-priority, 
meaning that they will take place as soon as the currently executing operation has 
completed. 

• Specify recursive operations 

A recursive operation is one that is performed repeatedly at specified intervals. 
Intervals can be specified on a monthly, weekly, daily, or hourly basis, depending 
on business requirements. 

The execution of occurrences of recursive plans can be conditioned on the success 
of previous occurrences. This means that a subsequent transmission can take 
place only if the previous one produced the expected result. If Monday's sales 
data was not sent successfully, Tuesday's occurrence of the same operation will 
not be generated and transmitted. 

• Hold operations at targets 

A user at a client workstation can temporarily suspend or prevent the execution of 
change control activities requested by the administrator by holding change control 
activity or by turning the workstation off. The functions are held and are executed 
when the workstation is switched on or the workstation is released. 



Distributing Data Files 

The term data distribution refers to the exchange of data files between client and server 
workstations within and across domains. You can use TME 10 Software Distribution 
facilities to distribute or retrieve data files such as: 

• User data files 

• Software packages and documentation 

• Problem management data files such as dumps, log files, and trace files 

TME 10 Software Distribution can distribute data files whether they have been 
cataloged or not. In addition, it provides facilities to compress and translate data during 
distribution. 

Compressing Data Files 

When large volumes of data are transmitted across a network, transmission efficiency is 
a significant factor in reducing time and cost. 
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TME 10 Software Distribution can send or retrieve data in compressed form. The 
compression format used can be either SNA, LZW, or based on a user-supplied 
algorithm. Compression substantially reduces both line transmission time and storage 
space requirements. After transmission, data can be expanded into its original form. 

Data compression facilities are available for data exchange within and across domains 
when your network uses the server-to-server communication protocol. 

Translating Data 

When different environments in your network use different data encoding techniques, 
TME 10 Software Distribution can perform data translation on files containing character 
data. A typical example of this requirement is transmitting data between systems that 
use ASCII encoding and those that use EBCDIC encoding. 

Data translation facilities are available for data exchange within and across domains. 

Data Distribution Functions 

The distribution functions of TME 10 Software Distribution are: 

Send The send function is used to send a file from a source target, which 

must be either the server or a local client workstation, to a destination 
target or group of targets, which can be either local or remote. The send 
function can be used from both server and client workstations. The 
action can be immediate or deferred until a specified time and date. It 
can also be issued with the replace option. 

Retrieve The retrieve function is used to retrieve a file from another target, which 
can be local or remote, onto a local server or client workstation. The 
retrieve function can be used from both server and client workstations. 
The action can be immediate or deferred until a specified time and date. 

Delete The delete function is used to delete files at local or remote targets. 



Installing on Pristine Workstations 

TME 10 Software Distribution can be used to install software on pristine workstations 
(workstations that have no software installed). For examples, see the INF file Pristine 
and Migration Scenarios in the product Information folder. 
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Chapter 5. Tracking Network Operations 



This chapter describes the facilities provided by TME 10 Software Distribution to track 
the hardware and software configuration of the workstations in your network. 



Keeping Track of Workstation Hardware Configurations 

You can use TME 10 Software Distribution facilities to keep track of the hardware 
configuration of the workstations in your network. This information is referred to as 
hardware inventory. 

You run an inventory discovery procedure to detect what hardware is present on a 
workstation. The output of the procedure is stored in a file in the server catalog. You 
can then make use of this hardware inventory information when you formulate the 
conditions for creating dynamic groups and software objects, and for change control 
and distribution requests. For instance, you can specify that a software object be 
installed only on workstations that have at least 10 MB of disk space available. Or you 
can define a dynamic group that contains only workstations with a graphic adapter 
installed, and install a graphics program only on those workstations. 

Inventory discovery is not a mandatory part of TME 10 Software Distribution. You can 
specify the hardware present on a target when you define it by specifying hardware 
parameters. However, the inventory discovery process is a way of catching this 
information and keeping it up to date automatically. 

You can run inventory discovery on remote targets if the targets involved in the 
operation are connected by the server-to-server (STS) transmission protocol. 

An inventory discovery program that takes advantage of NetFinity inventory capabilities 
on workstations that run OS/2 and Windows TME 10 Software Distribution products is 
provided. It is called fndinv, and it creates at each target output files (fndswinv, 
fndhwinv, and fndtkinv) that are then used by TME 10 Software Distribution. 

Inventory data is transferred from clients to the server when you do either of the 
following: 

• From the command line interface, submit the nvdm inv command. 

• From the graphical interface, select Inventory from the Selected pull-down menu 
in the Targets window. 

Note that for fndinv to work, the OS/2 or Windows client must have the Hw/Sw 
Discovery Tool component installed. 



Keeping Track of Workstation Software Configurations 

You can keep track of the software installed on the workstations in your network using 
two methods: 
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Keeping Track of Workstation Software Configurations 



• Running software inventory procedures 

• Referring to the change control status information in the catalog. 

Software Discovery Information 

You can run inventory discovery procedures to detect the software installed on 
workstations. These procedures are similar to those described for hardware inventory 
in |“Keepinq Track of Workstation Hardware Configurations” on page 35| 

Change Control Status Information 

Change control status is stored in the server catalog for each software package 
installed on each client workstation in a domain. The catalog also includes the change 
control history for the software installed on the server itself. When a change control 
operation is executed on a client workstation, a report of the operation results is 
generated and routed to the workstation in the network that originated the operation. 

The status information in the catalog can report a software object as being: 

Active/Inactive: The software object is installed either in the active area of the target 
file storage or only in the service area. 

Available/Not authorized: The software object is stored on the server and is available 
for use by the target, or the target has not been authorized to use it. 

Back level: The software object is a previous version of the software that was backed 
up after a more recent version was installed, but is reactivated because the more 
recent version was removed. 

Discovered: The software object was discovered by an inventory discovery 
procedure. It is installed on the workstation, but was not installed by a 
TME 10 Software Distribution procedure. 

Distributed: The software object was distributed to this target from another target. 

Distribution pending: The software object is currently being distributed. 

In error: A change control operation using the software object has failed without 
recovery, leaving the installation in an unpredictable state. 

Installed/Not installed/ln progress: The software object is either installed, is not 
installed, or the installation is currently in progress. 

Reboot required: When the software object was installed, REBOOT REQUIRED=YES 
was specified. To use the new software, restart the workstation so that the changes in 
the file become operative. 

Removable/Not removable: The software object is installed on the target and can be 
removed and replaced with an earlier version (rolled back), or cannot be removed. 
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Tracking the Progress of Change Control Operations 



Before sending software objects to clients, you can check the status of the software on 
the client. The operations that you can schedule for a client depend on the status of 
software, as shown in Table 6. You can use change control status infor mation to 

specify conditions in dynamic software objects and dynamic groups (see “How l 

Grouping Targets Can Facilitate Change Control Operations” on page 23| and [“Installing! 



the Same Software Object on Different Workstations” on page 28| ). For example, you 



can schedule a remove operation only on those workstations in your network where the 
status of a software object is in error. 



Table 6. Software Object Status and Associated Functions 


Status 


Install 


Accept 


Activate 


Remove 


Uninstall 


Available 


Yes 


No 


No 


No 


No 


Distributed 


Yes 


No 


No 


No 


No 


In error 


Yes 


Yes 


Yes 


Yes 


Yes 


In progress 


No 


No 


No 


No 


No 


Installed, Removable, Active 


No 


Yes 


No 


Yes 


Yes 


Installed, Not removable, Active 


No 


No 


No 


No 


Yes 


Installed, Removable, Inactive 


No 


Yes 


Yes 


Yes 


Yes 


Installed, Not removable, Inactive 


No 


No 


Yes 


No 


Yes 



Tracking the Progress of Change Control Operations 

Change control and distribution operations that have been submitted to the system for 
execution are referred to as requests. You can display reguests to follow their progress 
and take any necessary remedial action. Detailed filtering mechanisms allow you to 
display only those reguests you are immediately interested in. You can view the 
progress of reguests according to: 

• The servers they were submitted from 

• The request queue sequence number 

• The global name of the files included in them 

• The type of operation being performed (install, remove, accept, activate) 

• Their status (in progress, successful, waiting, held, deleted, failed, not started) 

• The severity level returned for errors (failed, warning, severe, hardware failure) 

• The scheduled date and time 

• The domains or the targets they address 

You can then act upon a request by: 

• Holding or releasing its execution 

• Deleting it 

• Rescheduling it 

• Restarting it 
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Chapter 6. Using Security Functions 



TME 10 Software Distribution provides security mechanisms that you can use to 
prevent unauthorized use of product functions and safeguard the privacy of sensitive 
data. You can define: 

• User profiles that limit the functions a user can perform 

• User access to targets 

• User access to data 

• Target authorizations for specific software objects 

• Security checks to be performed on the files in software objects before they are 
installed on workstations. 

TME 10 Software Distribution users must have a user ID to access the product. You 
can provide additional security by assigning passwords to users as well. 

The following sections describe the authorizations contained in user profiles, and how 
to define user access to data and to targets. 



Defining User Authorization Profiles 

User authorization profiles define the functions that each user can perform with the 
product. You can define profiles to be used by groups of users who perform similar 
tasks, or you can define individual profiles for each user. 

You can take advantage of three default authorization profiles, which are created during 
installation and stored at the server. 

Administrators (FNDADMN) 

Administrators have access to all operations, including the administrative and 
configuration functions. 

When you define user authorizations, keep in mind that all FNDADMN users can 
perform operating system specific operations that require root and bin 
authorizations. 

jTable 7 on page 40l lists the values set for this profile. 
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Defining User Authorization Profiles 



Table 7. Administrator Profile (FNDADMN) 


Function 


Authorization 


Change management 


Install, Remove, Accept, Uninstall 

Execute 

Activate 

Authorize, Unauthorize, Delete History 
All targets 


Distribution 


Send 

Retrieve, Delete 


Preparation 


Build, Unbuild, Catalog, Delete, Create, View 


Queues 


Manage 


System administration 


Modify 


Configuration 


Modify 


Erase requests 


Authorize 


Manage requests 


All 



Builders (FNDBLD) 

Builders are authorized to perform change control preparation functions. That is, 
they can prepare and build software objects. Table 8 lists the values set for this 
profile. 



Table 8. Builder Profile (FNDBLD) 


Function 


Authorization 


Change management 


Install, Remove, Accept, Uninstall 

Execute 

Activate 

All targets 


Distribution 


Send 

Retrieve, Delete 


Preparation 


Build, Unbuild, Catalog, Delete, Create, View 


Queues 


View 


System administration 


View 


Configuration 


View 


Erase requests 


Authorize 


Manage requests 


All 
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Defining User Access to Data and Targets 



Users (FNDUSER) 

Users can distribute files and display the configuration. Table 9 lists the values 
set for this profile. 



Table 9. User Profile (FNDUSER) 


Function 


Authorization 


Change management 


Install, Remove, Accept, Uninstall 

Execute 

Activate 

Only on target where the user is working 


Distribution 


None 


Preparation 


None 


Queues 


View 


System administration 


None 


Configuration 


None 


Erase requests 


No authorization 


Manage requests 


None 



Defining User Access to Data and Targets 

Define data access keys (DAKs) to determine the objects in the catalog that a user can 
work with, and define target access keys (TAKs) to determine the targets a user can 
access. You define them in the following way: 

• When you build or catalog a software object, a data file, or a plan, you specify the 
DAK associated with it. A catalog entry can have only one DAK, but you do not 
have to assign it one at all if it is not necessary. No DAK is the default. 

In the same way, when you define a target you specify the TAK associated with it. 

• When you define a user, you determine the catalog entries the user can access by 
specifying the DAKs the user is associated with, and the targets the user can 
access by specifying the user's TAKs. A user can have up to 32 DAKs and TAKs 
(which is the maximum number defined to the system). The default is no DAKs or 
TAKs, in which case the user can work only with objects or targets that do not 
have DAKs or TAKs. 

When a user issues a command against a catalog entry or for a target, the system 
checks to verify that the object or target and the user have the same DAK or TAK. 
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Defining Data Security 

Since software objects are usually prepared at preparation site workstations, then 
stored on servers before being distributed around a network and installed, it is 
important to ensure that their contents are not tampered with before an actual 
installation takes place. This is especially critical when a software object contains 
sensitive data. 

TME 10 Software Distribution provides the following mechanisms: 

• When you are building a remote source software object, specify Secure package 
in order to: 

- Verify that the remote files specified are accessible, when the software object 
is built. 

- Verify that the files are the same as those specified when the software object 
was built, when the software object is installed. 

• In addition, you can activate user exits that perform the following functions in 
connection with the secure package attribute: 

- When the software object is built, assign a secure key to it by calculating its 
CRC (Cyclic Redundancy Check) number. 

- When the software object is installed at a client, the client product proceeds 
with the installation only if the secure key is the same as the one originally 
assigned, and only if the secure key identifies the workstation where the 
software object was built. 
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Chapter 7. Finding and Using TME 10 Software Distribution 
Information 



This chapter tells you where you can find more information about TME 10 Software 
Distribution functions and how to use them. 

I It makes reference to files that can be found on the media on which the product is 

I provided. TME 10 Software Distribution is provided on two CD-ROMs: 

I CD Number CD Name Product 

I Number 

I LK3T-5087-00 TME 10 Software Distribution, Version 3.1 .5 for OS/2, 5698-SWD 

I Windows 2000, Windows NT, Windows 95/98, 

I Windows 3. lx, NetWare 

I LK3T-5088-00 TME 10 Software Distribution, Version 3.1 .5 for AIX 5698-SWD 



Information about Messages and Error Codes 

All TME 10 Software Distribution messages are logged in the message log. You can 
view it in the Message Log window of the graphical interface, or by entering the nvdm 
log command from a command prompt. 



Viewing Online Information 

If you installed the Distribution Server Documentation or Distribution Client 
Documentation option, then to see files of online information, click on the 
Documentation icon in the product folder. The Documentation folder, shown in 
Figure 7, is displayed. 




Figure 7. Distribution Server documentation - icon view 
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Viewing Online Help 



The icons in the folder represent these items: 

• Quick Beginnings, an INF file (FNDOSMST.INF) of this book. 

• Clients Installation and Configuration, an INF file (FNDCIMST.INF) of the manual 
that explains how to install and configure clients for the OS/2, AIX, Windows 2000, 
Windows NT, Windows 98, Windows 95, and Windows 3.11 platforms. 

• A Readme file (README. INF), which contains information about limitations and 
about changes made to TME 10 Software Distribution, Version 3.1.5 for OS/2 or to 
the publications after the publications went to press. 

• Command Reference, an INF file (FNDR6MST.INF) that contains reference 
information about the TME 10 Software Distribution, Version 3.1.5 for OS/2 
command line interface. 

• Message Reference, an INF file (FNDM6MST) that contains reference information 
about the messages issued by TME 10 Software Distribution, Version 3.1.5 for 
OS/2. 

• Pristine and Migration Scenarios, an INF file (FNDS6MST.INF) that contains 
detailed examples of the use of TME 10 Software Distribution to install software 
on pristine workstations and to migrate from one version of an operating system to 
another. 

• ADF Information, an INF file (ADF.INF) that explains how to create the file that is 
required to prepare an application for CID installation through TME 10 Software 
Distribution. 

• Trademarks, an INF file (TRADEM.INF) that lists trademarks used in the product. 

To display an INF file, click on the icon or use the VIEW command. 



Viewing Online Help 

Help information is available for every menu item on pop-up and pull-down menus, and 
every place you see a Help push button. 

General Help 

FI help provides information about objects, pop-up menu items, entry fields, and push 
buttons. To use the FI help, select or highlight an item and press the FI key on your 
keyboard. 

Another way to get help is to use the Help push button available on most notebook 
pages, and the Help menu item on most object pop-up menus. These sources enable 
you to work with an object while you learn how to use it. 

Message Help 

Messages issued for selected TME 10 Software Distribution, Version 3.1.5 for OS/2 
services are displayed in a pop-up window that has a Help push button. Select this 
push button to see an explanation of the message. 
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Printing the Documentation 



From the command line, you can get message help by issuing the command: 

HELP FNDM6MST <msgno> 

where msgno is the message number. 

Command Help 

To obtain help with the syntax of a software distribution command, do the following: 

1 . At the OS/2 command prompt type: 

NVDM 

The following prompt appears: 

NVDM> 

2. At the NVDM> prompt type: 

HELP <command> - 

where: 

<command> 

is the command name. 

The syntax and parameters for the command appear; for example: 

NVDM> HELP LSTG 

gives you the syntax and parameters for the command LSTG. 

From the command line, you can get command help by issuing the command: 

HELP FNDR6MST <cmdname> 

where cmdname is the name of the command. 



I Printing the Documentation 

I TME 10 Software Distribution documentation is available on the product CD in 

I PostScript and PDF formats. 

I PostScript Format 

I Files of the TME 10 Software Distribution documentation formatted for a PostScript 

I printer are supplied on the product CD-ROM under the directory SD4DOCPS, which 

I contains the following files: 
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Filename Document name 

FNDNTMST.PS TME 10 Software Distribution for Windows NT Quick Beginnings 

FNDOSMST.PS TME 10 Software Distribution for OS/2 Quick Beginnings 

FNDNWMST.PS TME 10 Software Distribution for NetWare Quick Beginnings 

FNDAXMST.PS TME 10 Software Distribution for AIX Quick Beginnings 

FNDR6MST.PS TME 10 Software Distribution for Windows NT and OS/2 Command 

Reference 

FNDA6MST.PS TME 10 Software Distribution for AIX Reference 

FNDNRMST.PS TME 10 Software Distribution for NetWare Command Reference 

FNDCIMST.PS TME 10 Software Distribution Clients Installation and Configuration 

FNDM6MST.PS TME 10 Software Distribution Message Reference 

FNDS6MST.PS TME 10 Software Distribution Pristine and Migration Scenarios 

FNDI6MST.PS TME 10 Software Distribution for AIX Installation Scenarios 

README.PS TME 10 Software Distribution README 

You can print them before or after you install TME 10 Software Distribution, Version 
3.1.5 for OS/2, using whatever method you have set up for printing to a PostScript 
printer. Because the files are large, use of a high-speed PostScript printer is 
recommended. 



PDF Format 

The TME 10 Software Distribution manuals are also available in PDF format, allowing 
them to be viewed or printed using Adobe Acrobat Reader, which can be downloaded 
free of charge from Adobe's Internet site (www.adobe.com); see the site for full details 
of platforms supported by Acrobat. The directory which holds the PostScript files also 
holds the same manuals in PDF format, where the filename of the manual is the same 
as that of the PostScript version but the extension is changed to .PDF. 

The manuals are fully hyperlinked, so that you link directly to pages from the Table of 
Contents and the Index, as well as from specific references in the text. 



Calling IBM Service 

The IBM Support Center provides telephone assistance in problem diagnosis and 
resolution in the United States and Puerto Rico. You can call the IBM Support Center 
at any time; you will receive a return call within eight business hours (Monday through 
Friday, 8 a.m. to 5 p.m., your local time). The number to call is (800) 237-551 1 . 

Outside the United States and Puerto Rico, contact your local IBM representative or 
your authorized IBM supplier. 
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Part 2. Installing and Configuring TME 10 Software Distribution 

This part describes what you must do to install the product and configure the network it 
will be running in. It includes these chapters: 



• IChapter 12, “Configuring for Communication with MVS” on page 91 1 

• Chapter 13, “Configuring Personal Communications/Communications Server” on 
page 113 

• IChapter 14, “Configuring STS Remote Connection Files” on page 1231 

• Chapter 15, “Configuring SNA/DS Remote Connection Files” on page 1 33 

Information about how to install and configure OS/2 and Windows clients is in the 
Installation and Configuration book for the client products. 



IChapter 8, “Planning” on page 49| 

IChapter 9, “Installing an OS/2 Distribution Server” on page 53l 



Chapter 10, “Editing the Base Configuration File” on page 73Fhapter 11, “Defining 



Users and Targets” on page 83 
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Chapter 8. Planning 



This chapter contains the hardware and software prerequisites for installing the 
TME 10 Software Distribution server. You select the components you want to install. 
Your options are: 

• Distribution server — required. The TME 10 Software Distribution catalog and the 
command line interface. 

• Distribution server GUI — optional. 

• Preparation site server — optional. The programs that support preparation of 
software objects. 

• Hardware/software discovery tool — optional. The programs that support hardware 
and software inventory discovery. These programs come from the NetFinity 
product. If your workstation already has NetFinity Manager or NetFinity Services 
installed, do not install this component of TME 10 Software Distribution. 

• Distribution server documentation — optional. The TME 10 Software Distribution 
manuals, message documentation, command documentation, and other information 
in INF format. 

Hardware and software prerequisites for TME 10 Software Distribution clients are in 
the TME 10 Software Distribution Clients Installation and Configuration manual. 



Hardware Prerequisites 

• The processor and memory requirements of the TME 10 Software Distribution 
server are those required to run the Operating System on which it is to be installed; 
thus you should consult the Operating System documentation. 

• Disk space for the TME 10 Software Distribution server, including the 
documentation, is approximately 45 MB 

• 10 MB disk space required temporarily during installation 

• Enough disk space to store the software objects for distribution. 

• CD-ROM drive for product installation 

• Token-ring or Ethernet card. 



Software Prerequisites 

The following is required on the distribution server workstation: 

• From OS/2 Warp 3. Ox to OS/2 4.5 Warp server for e-business 

• Products to support the appropriate communication protocols (see |“Communication 
iProtocols” on page 50[ . 

• To install CID-enabled products on clients, one of the following is required: 

- LAN Server and LAN Requester 
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- NFS 

- SRVIFS 

- NetWare Server and NetWare Requester 



Communication Protocols 

Communications protocols are required for server and client communication and for 
connecting an OS/2 distribution server to an MVS or AIX focal point. 



Protocols to Connect to Another Server 

The following protocols are supported for an OS/2 Server communicating with another 
TME 10 Software Distribution Server. 

Server-to-Server (STS) Protocols 



Table 10. STS Protocols to Connect to Another Server 



Platform 


Communications Protocol 


OS/2 


APPC 




IPX 




NetBIOS 




TCP/IP 


NetWare 


IPX 




TCP/IP 


Windows NT or Windows 2000 


IPX 




NetBIOS 




TCP/IP 


AIX 


APPC 



TCP/IP 

SNA/DS Protocols: APPC is the only protocol available to connect to servers using 
SNA/DS. 

Protocols to Connect to a Client 

The following protocols are supported for an OS/2 server communicating with a 
TME 10 Software Distribution Client. 
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Communication Protocols 



Table 1 1. Protocols to Connect to A Client 

Platform Communications Protocol 

OS/2 APPC 

IPX 

NetBIOS 

TCP/IP 

NetWare IPX 

TCP/IP 

Windows NT or Windows 2000 IPX 

NetBIOS 

TCP/IP 

Windows 95 or Windows 98 NetBIOS 

TCP/IP 

Windows 3.11 NetBIOS 

TCP/IP 

AIX TCP/IP 

Protocols to connect to a focal point 

For communication with an MVS focal point the APPC protocol should be used. 

Server/Client Communications 

The communications software requirements depend on the level of the operating 
system on which TME 10 Software Distribution is running: 

Warp 3.0x to Warp 4.0 

NetBIOS Multiprotocol Transport Services (MPTS) 1.0 or later (LAPS level 
WR08000) 

NetBIOS resources required on an OS/2 distribution server are 25 
sessions, 25 commands, and 2 names. 

TCP/IP IBM TCP/IP for OS/2; the version required depends on the level of 

MPTS/LAPS installed: 

MPTS/LAPS level TCP/IP Version to use 

WR08210 3.x 

WR08415 4.0 (see Info APAR 1 1 10529 for more details) 

WR08600 4.1 

IPX/SPX Novell NetWare Requester 2.10 or later 

APPC Communications Server 4.1 or later or Personal Communications 4.1 or 

later. 

OS/2 4.5 Warp Server for e-business 

With OS/2 4.5, the following resources are automatically installed as part of the 
Operating System package: 
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NetBIOS Multiprotocol Transport Services (MPTS) 5.5 

NetBIOS resources required on an OS/2 distribution server are 25 
sessions, 25 commands, and 2 names. 

TCP/IP IBM TCP/IP for OS/2 4.2.1 

IPX/SPX Novell NetWare Requester 2.10 or later 

The following needs to be installed: 

APPC Communications Server 5.0 or later. 



Communications with a Focal Point 

Communication with NetView DM for MVS will be via APPC; please see the APPC 
details given above. 

For communication with TME 10 Software Distribution for AIX over TCP/IP, IBM 
TCP/IP for OS/2 3.0 or later, is required on the distribution server. 

For communication with TME 10 Software Distribution for AIX over APPC, please see 
the APPC details given above. 



Prerequisites on the Host System 

To perform software distribution from an MVS system to TME 10 Software Distribution, 
the MVS system must have NetView DM for MVS Release 6.2 or 7 installed; however, 
if you wish to enable the host to delete pending requests at the server, it must be 
Release 7. 

To perform TME 10 Software Distribution from an AIX system to TME 10 Software 
Distribution, the AIX system must have TME 10 Software Distribution 3.1.4 for AIX, or 
later, installed. 
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Chapter 9. Installing an OS/2 Distribution Server 



This chapter explains how to: 

• Install an OS/2 distribution server interactively from the CD-ROM ^‘Installing an 
IOS/2 Distribution Server Interactively”! . 



• Use the APPC configuration SmartGuides to configure for communication with 
NetView DM for MVS, TME 10 Software Distribution for AIX, other OS/2 servers, 



and OS/2 clients 


“Using the APPC Configuration SmartGuides to Connect Over| 


ISNA” on page 66 


i. 



• Configure for TCP/IP communication with TME 10 Software Distribution for AIX, 
both at the TME 10 Software Distribution site {“Configurin g TCP/IP for| 
[Communication with a Remote Server” on page 68j and at the TME 10 Softw are 
Distribution for AIX site {“Configuring at the Remote Server Site” on page 69| . 



Installing an OS/2 Distribution Server Interactively 

This section describes how to install a distribution server interactively from the 
CD-ROM. 



Follow these steps: 



1 



Insert the TME 10 Software Distribution CD-ROM 
from the SD40S2MMAGES dire ctory, type install 
shown in jFigure 8 on page 54| is displayed. 



(number LK3T-5087-00) and, 
. The Welcome window, 



© Copyright IBM Corp. 1993, 2000 
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Figure 8. TME 10 Software Distribution welcome window 
2 Select Continue. The Install window, shown in Figure 9, is displayed. 




Figure 9. TME 10 Software Distribution install window 

3 Select Update CONFIG.SYS and then select OK. 
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4 In the Install - directories window, shown in |Figure 10 on page 55[ select the 
components to install and the installation directory. This window includes the 
default for the TME 10 Software Distribution installation directory, SOFTDIST. 



Install - directories 



Select the components that you want to install: 




Bytes needed: 40.000.000 



Enter the directories where you want to install the 
components. These directories will be created if they do not 
already exist. 














Install... 




Disk space... 




Cancel 


Help 











Figure 10. TME 10 Software Distribution install - directories window 



Select the components you want to install and the drive on which to install the 
product. 

It is recommended that you install Distribution Server Documentation; the online 
helps sometimes refer to the INF documentation, and if you have not installed 
these files, you will not be able to link to them from the helps. To view these files 
after installation requires no software other than the operating system. 



5 



Optionally, click on Disk space... to view disk space available on all your drives, 



as shown in Figure 1 1 on page 56 



Chapter 9. Installing an OS/2 Distribution Server 55 












Installing a Server 




Figure 11. Disk space window 

Select a drive and click on OK. 

6 In the Install - directories window, select Install. 

Installation begins. Progress is shown in the Install - Progress window, shown in 
Figure 12. 




Figure 12. TME 10 Software Distribution install - progress window 

7 Installation continues until the Distribution Configuration notebook, shown in 
[Figure 13 on page ~57| is displayed. 

(Note that you can change the settings in this notebook after installation by using 
the Configuration icon in the TME 10 Software Distribution folder.) 
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Distribution Configuration 



General 



System name 



Distribution 



Enterprise Connectivity 



Protocols 

13 Novell IPX 
Sewer address 



0000000008005AF4A 



3 NetBIOS 
Sewer address 



08005AF4AD8D 



3 TCP/IP 

Sewer hostname 



3 SNA 

netid.netlu.lumode 



iti b mOpc. ItO 5 5a0 . 1 u 62 



General Parameters 



Figure 13. Distribution Configuration Notebook general page 



Use the General page to specify the system name and the communication 
protocols to be used. 

You can implement any combination of NetBIOS, IPX/SPX, TCP/IP, and SNA for 
communication between the distribution server and its clients. You can also 
implement SNA for communication with NetView DM for MVS. For example, if 
you configure NetBIOS and TCP/IP on the distribution server, the server can 
communicate with TME 10 Software Distribution clients that have either NetBIOS 
or TCP/IP, or both, configured. 

Enter information in the following fields: 

System name 

Name of this system in the TME 10 Software Distribution environment. 
This name can be, but is not required to be, the same as the NetBIOS 
name or TCP/IP hostname. The name cannot contain embedded 
blanks, and cannot contain the characters * (asterisk), \ (backslash), 
and ? (question mark). 

Note that the system name is case sensitive. 

Protocols 

Check the box next to the protocol name to enable the distribution 
server to communicate over the selected transport protocol. You can 
enable one protocol or multiple protocols. 
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If you choose to enable SNA, fill in the values for netid.netlu.lumode. 
For the other protocols, the installation process fills in the required 
values. 

8 Use the Distribution page of the Distribution Configuration notebook, shown in 
Figure 14, to select software distribution configuration parameters. 




Figure 14. Distribution Configuration Notebook distribution page - Server 

The default directories are shown in the figure. 

The fields of this page are as follows: 

Machine type 

Software distribution workstation role. This entry is set to Server and 
cannot be changed. 

Backup area 

An area where backups of previous levels of applications are kept, for 
applications installed removably. For example, if you install Microsoft 
Word for Windows 2.0b on this machine and after six months you 
install Word for Windows 6.0, a backup of the previous version is 
stored in the backup area. This entry applies to applications installed 
through software distribution on this machine. 

Service area 

Temporary area for installations. 
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Repository 

Subdirectory for profiles and software objects. 

Work area Temporary area used by TME 10 Software Distribution during the 
resolution of change management requests. 

Note: The paths that you specify in the Directories field group of the Distribution 
Configuration window must be the same path that you specify in the 
Installation Directory field of the Install - Directories window. If you want 
to change this path as in this scenario, edit the nvdm.cfg file after you 
complete the installation. 

Domain Address 

If you will be connecting to a distribution server on MVS or AIX, this 
is the name of the domain to which this TME 10 Software 
Distribution server and its distribution clients belong. 

By default, this name is equal to the first eight characters of the 
System name you entered in the General page of this notebook. 

Target Address 

The name by which this distribution server is to be known by the 
MVS or AIX TME 10 Software Distribution server and the distribution 
clients in the LAN. 

By default, this name is equal to the first eight characters of the 
System name you entered in the General page of this notebook. 

9 If you plan to connect to NetView DM for MVS or TME 10 Software Distribution 
for AIX, use the last page of the Distribution Configuration 
parameters related to enterprise connectivity, as shown in 



notebook to select 
Figure 15 on page 60 
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Figure 15. TME 10 Software Distribution Enterprise connectivity parameters 



Enter information in the following fields: 

Remote Communication Enabled 

Remove the check from this box if you want to disable remote 
communication with MVS and AIX. 

Remote Software Distribution Server 

Use this container to list all remote software distribution servers to 
which this distribution server can be connected. Each remote software 
distribution server is listed by domain name and server name. It can be 
either a NetView DM for MVS system or a TME 10 Software 
Distribution for AIX server. 



When you click on Add, the Remote server connection window is 



displayed, as shown in | Figure 16 on page 61 
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Remote server connection 



Remote Server Name 




Domain Address 


TOLEDO 


Target Address 


HOMEOFC 



Protocol 
Local LU Alias 
Mode Name 



Remote Server Address 

Network ideritmfri [ 

Lo line a! Ur-n N am & 


iOMF OFO 


0 Focal Point 


OK Cancel 


Help 



APPC 



Figure 16. Remote server connection window 

Enter values in the following fields: 

Domain Address 

Enter the name of the network to which the remote server 
belongs. If the remote server is a NetView DM for MVS system, 
this name must be the same as the network ID of the partner LU 
in the Personal Communications APPC configuration of this 
workstation. If the remote server is a TME 10 Software 
Distribution for AIX system, this is the domain address of the 
TME 10 Software Distribution for AIX server. 

The name can be up to eight characters long. The characters can be 
letters, numbers, or the special characters @, $, and #. 
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This name and the target address provide full identification for the 
remote server in the Remote Software Distribution Server container in 
the form: 

<Domain address>.<Target address> 

You can enter an asterisk (*) as a wildcard name. An asterisk as 
domain address implies that any of the defined domains is considered 
valid. 

Target Address 

Enter the remote server name. 

If the remote server is a NetView DM for MVS system, the target 
address is the logical unit (LU) name assigned to NetView DM 
for MVS; it must therefore correspond to the name of the partner 
LU in the Personal Communications APPC configuration of this 
workstation. 

If the remote server is a TME 10 Software Distribution for AIX 
server, this name is the target address of the TME 10 Software 
Distribution for AIX server. 

The name can be up to eight characters long. The characters 
can be letters, numbers, or the special characters @, $, and #. 

This name and the Domain Address provide full identification, for 
the remote server in the Remote Software Distribution Server 
container, in the form: 

<Domain address>.<Target address> 

You can enter an asterisk (*) as a wildcard name. An asterisk 
as Target Address implies that any of the available remote 
servers is considered valid. 

Protocol 

Select the protocol that the remote server and this distribution 
server will use to communicate. 

Select APPC if the remote server is a NetView DM for MVS 
system. This requires that Personal Communications be 
installed and configured on the TME 10 Software Distribution 
distribution server. Select TCP/IP if the remote server is a 
TME 10 Software Distribution for AIX server. This requires that 
TCP/IP be installed and configured on the TME 10 Software 
Distribution distribution server. 

Some of the information requested changes according to which 
communication protocol you select here. 

Local LU Alias (APPC only) 

The LU alias name that identifies your software distribution 
program to Personal Communications when an APPC session is 
established with the NetView DM for MVS remote system. 
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Enter the local LU alias name that identifies this workstation, as 
defined in your Personal Communications APPC configuration. 

The name is case sensitive, so it must be entered exactly as in 
the Personal Communications configuration. 

If you do not enter a name here, Personal Communications uses 
the defined local LU name or local CP name in lieu of the local 
LU alias (if you have a working Personal Communications APPC 
configuration). 

Mode Name (APPC only) 

The name of the logon mode table entry, in the MVS system, 
containing the session parameters used for establishing the 
APPC session between NetView DM for MVS and this 
TME 10 Software Distribution distribution server. Enter the 
name of the mode as defined in your Personal Communications 
APPC configuration. 

If you do not specify a mode here or in Personal 
Communications, then Personal Communications uses one of 
the default IBM-supplied modes. Note, however, that to 
communicate with the MVS remote system, the mode definition 
must include: 

P LU_M0DE_S ESS 1 0N_L I M I T= 1 

Network Identifier (APPC only) 

The name of the network to which the NetView DM for MVS 
system belongs. 

If you already entered a domain address in this window, this 
field appears as read-only. If you did not enter a name in the 
Domain Address field, then you must enter one here. 

Logical Unit Name (APPC only) 

The logical unit name of the NetView DM for MVS remote 
server. 

If you already entered a Target Address name in this window, 
this field appears as read-only. If you did not enter a name in 
the Target Address field, then you must enter one here. 

HostName (TCP/IP only) 

The host name of the remote TME 10 Software Distribution 
server. 

Focal Point 

Select this check box if the remote server is configured to 
function as a software distribution focal point. 

This means that, beside being able to initiate software 
distribution operations on remote targets, the remote server can 
receive and store software distribution reports from this 
TME 10 Software Distribution distribution server. 
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This box is grayed out if you already have a focal point defined. 

Click on OK to add the remote server to the Remote Software 
Distribution Server container, as shown in Figure 17. 




TOLEDO.HOMEOFCf Focal Point) 



21 Remote Communication enabled 



General 



Distribution 



Remote Software Distribution Server 



Enterprise Connectivity 



Delete 



Enterprise Connectivity Parameters 



Figure 17. Enterprise connectivity page with remote server added 

Close the notebook to save the configuration parameters. 
10 Installation continues with the window shown in Figure 18. 




Figure 18. Configuration confirmation window 

Select Yes to activate the configuration and continue installation. 

1 1 Installation ends. A pop-up message is displayed telling you that the new 
configuration will be used when the program is restarted. Select OK. 
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12 Select Exit in the bottom right corner of the screen. Shut down and restart the 
system. The TME 10 Software Distribution icon is added to the desktop. 



Logging on as the Root User 

During installation, TME 10 Software Distribution defines the user root and configures it 
as the only user on both the server and any client. Root can be used to access the 
system initially and perform configuration tasks. 

When the system defines the user root, it does not assign any password. Root can log 
on to the TME 10 Software Distribution server using the user ID only. For security 
purposes, at the TME 10 Software Distribution server, assign a password to root, 
which TME 10 Software Distribution will request at logon. 

To assign a password to root, at the C: command prompt, enter the command: 
nvdm updpwd root - n <pwd/pwd> 

where <pwd> is the password (you must type it twice). It must be between six and 
eight characters long. 



Assigning a Password to the User Root 

If you assign a password to the user root, you must add this password to the following 
icons and files: 

• The Start and Stop TME 10 Software Distribution Server icons, which you select 
from the TME 10 Software Distribution folder. 

• The Start TME 10 Software Distribution Server icon, which you select from the 
OS/2 System - Icon View folder. 

• The FNDUPD.CMD file 

• The FNDINV.CMD file 

• The FNDMIG.CMD file 

• The FNDRCH.CMD file 

If you do not perform these updates the product does not start correctly at the 
automatic startup. 

To add the root's password to the various Start and Stop TME 10 Software Distribution 
icons, perform the following steps: 

1 . Locate the icons: 

• In the TME 10 Software Distribution folder you will find a Start 

TME 10 Software Distribution Server icon and a Stop TME 10 Software 
Distribution Server icon 

• To find the Start TME 10 Software Distribution Server icon in the OS/2 
System - Icon View folder you should: 

a. Click on the OS/2 System icon. The OS/2 System icon View folder 
appears 
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b. Click on the Startup icon. The Startup - Icon View folder appears 

2. For each icon in turn, click on the icon with the right mouse button, and select 
Properties. The icon Properties window appears. 

3. Select the Program tab. 

4. Update the Optional Parameters field by adding the -p parameter as follows: 
start -u root -p <password> 

where <password> is the root's password. 

To update the FNDUPD.CMD, the FNDINV.CMD, the FNDMIG.CMD, and the 
FNDRCH.CMD, files stored in the SOFTDIST\BIN directory, edit the files and enter the 
-p <password> parameter in the line that contains the nvdm command. 



Using the APPC Configuration SmartGuides to Connect Over SNA 

The APPC Configuration SmartGuides included with TME 10 Software Distribution 
provide an easy way to configure an APPC connection between the OS/2 server and: 

• NetView DM for MVS 

• TME 10 Software Distribution for AIX 

• Other TME 10 Software Distribution OS/2 servers and clients 

To configure an APPC link between a software distribution server and a partner, you 
configure a connection between two transaction programs that reside on the two 
systems. 

The transaction programs are supplied by TME 10 Software Distribution for the OS/2 
servers and clients, and by NetView DM for MVS and TME 10 Software Distribution for 
AIX for those platforms. 

Every time the APPC connection is established, a remote conversation can take place 
between the two transaction programs; the programs take turns sending requests and 
waiting for their replies. 

When you configure an APPC connection, you define two logical units of type 6.2, one 
per system, that provide the path through which the conversation can take place. You 
define to each system the name of the logical unit and transaction program for the local 
system and for the remote system (partner). You also define the mode in which the 
conversation takes place. 

The SmartGuides help you to create the APPC configuration for your server. You enter 
the required values, and the tools take care of using the values where they are needed. 

For APPC communication with another OS/2 server, an OS/2 client, or 
TME 10 Software Distribution for AIX, the SmartGuides generate Personal 
Communications APPC configurations. The APPC With NetView DM for MVS 
SmartGuide goes a step further. It can also create host definition files, which you can 
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send to your host administrator, and it does a minimal configuration for 
TME 10 Software Distribution. 

You can find the SmartGuides in the APPC Configuration SmartGuides folder located 
in the main product folder. There are two icons, as shown in Figure 19: 

• APPC with NetView DM for MVS 

• APPC with Other Servers and Clients 



TME 10 APPC Configuration SmartGuides - Icon View 



© C 

APPC with NetViewDM for MVS APPC with Other Servers and Clients 



Figure 19. SmartGuides - icon view window 
These icons start the corresponding SmartGuides. 

In each SmartGuide, you first supply a configuration name. The tool uses it to name the 
configuration files it creates. Next, you provide the requested names and addresses, 
first for the server, then for the partner(s) with which the APPC connection will be 
established. 

After you have finished entering the configuration information, the SmartGuide creates a 
response file to generate the Personal Communications configuration and optionally 
install Personal Communications; this response file can later be installed by the 
SmartGuide with the Personal Communications CMSETUP command. 

The APPC With NetView DM for MVS SmartGuide can also generate: 

• A list file with VTAM definitions and one with NCP definitions; you can send them 
to your host administrator to generate a definition for the TME 10 Software 
Distribution server. 

• A list file with the NetView DM for MVS node definition for the server; you can send 
it to your host administrator to generate a definition for the TME 10 Software 
Distribution server. 

• An update for the TME 10 Software Distribution configuration notebook defaults 
file, so that the Mode and Local LU Alias names will appear as defaults in the 
Remote Server Connection page of the notebook. 

After the files have been created, you can choose to review them and change some of 
the preset keyword values. 

Finally, you can have the SmartGuide install the response file automatically to generate 
the Personal Communications APPC configuration files. Alternatively, you can just exit 
the tool and have it installed at another time by reentering the configuration name. 
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In the APPC with NetView DM for MVS SmartGuide, if you generate the response file 
but exit the tool without installing it, you will have to run CMSETUP /R by hand. The 
response file, named ConfigurationName.RSP is saved in the SOFTDIST\BIN 
subdirectory; open an OS/2 session and from that subdirectory, enter: 

CMSETUP /R ConfigurationName.RSP 

In the APPC With NetView DM for MVS SmartGuide, you can also install the update to 
the TME 10 Software Distribution configuration. 




1. The SmartGuides generate only new Personal Communications APPC 
configurations; they cannot update existing configurations. 

2. When you install the Personal Communications response file, the resulting 
configuration files are added to the CMLIB directory. You can make the new 
configuration the current one through CMSETUP. Any existing configurations you 
may have are not deleted, but you may have to add additional features manually. 



Configuring TCP/IP for Communication with a Remote Server 

This section describes how to complete TCP/IP configuration on your 

TME 10 Software Distribution server to allow communication with a remote server. 

You need to perform these tasks only once, when TCP/IP is installed. 

You must provide the following information: 

• The name of the network interface you are using, for example, token ring or 
Ethernet. 

• The host name for the workstation that you are configuring. This is the TCP/IP 
name by which this node is known. 

• The Internet address of the node. 

• The Internet address mask to define subnetworks if appropriate. 

If you are in doubt about values for these fields, use the TCP/IP configuration online 




In many cases, TME 10 Software Distribution is installed on a working 
system. If the workstation is already using TCP/IP, you do not need to perform these 
configuration steps. 
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Configuring at the Remote Server Site 

To enable communication between an OS/2 distribution server and a remote server, 
follow these steps at the remote server site: 

1 Edit the STS routing table to identify the TCP/IP connection between the remote 
server and your distribution server. Figure 20 shows an example of the STS 
routing table for a remote server (in this case AIX). 



1 

# This table provides STS routing information for 


# TCP/IP routes. 

# This file should be stored 


as /usr/1 pp/netvi ewdm/db/routetab 


NETWORK PROTOCOL: TCP/IP 




# 

# Destination Connection 


Hop 


# Address 

# 


Count 


0S2SRV1 .0S2SV1 0S2SRVR 


10 



Figure 20. Example of an STS Routing Table for TCP/IP routes on an AIX remote server 



Be sure NETWORK PROTOCOL is TCP/IP. 



The format of the destination address in the STS routing table is domain 
address. target address. To get the domain address and target address, on the 
TME 10 Software Distribution distribution server, enter the command: 

nvdm Istg -1 

In this example, domain address is OS2SRV1 and target address is OS2SV1. 
The connection name is any name you choose (in this example, OS2SRVR). 



2 



Create an STS connection configuration file. The name of the file must be the 
connection name you specified in the STS routing table (in this example, 
OS2SRVR) 



F igure 21 on page 70| is an example of an STS configuration file for 



a remote server. 
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# STS CONNECTION CONFIGURATION FILE FOR CONNECTION OS2SRVR 

# 

# This connection is used to handle transmissions between 

# TME 10 Software Distribution for AIX 

# and TME 10 Software Distribution for OS/2 

# using STS across TCP/IP. 

# 

# This file should be stored as /usr/1 pp/netviewdm/db/routetab 

PROTOCOL: TCP/IP 

TYPE: STS 

REMOTE SERVER NAME: 0S2SRVR 



Figure 21. Example of an STS Connection Configuration File for a remote server 

Set REMOTE SERVER NAME to the workstation name of the remote 
TME 10 Software Distribution distribution server. 

3 Now add the remote TME 10 Software Distribution distribution server as a target. 
Enter the command: 

nvdm addtg workstation name -b server-y os/2. ► 

-s target address -tp tcp -.hostname 

4 Enter the command: 
nvdm rid 



Updating Your Installation 

You may need to update your installation, for example to add a component you had not 
installed previously, or you may wish to uninstall TME 10 Software Distribution. To do 
so, click on the Installation Utility icon in the product folder. The Installation and 
Maintenance window is displayed. Use the Action pull-down menu, as shown in 
Fi gure 22 on page 71 1 to specify what you want to do. 
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Figure 22. Installation and maintenance window 

Use Install... to return to the interactive installation process and install components that 
were previously not installed. 

Use Update... to install new versions of components and fixes. 

Use Delete... to uninstall the product. 

Be sure to stop the distribution server before making any changes to your installation. 



Updating Your Configuration 

To modify your configuration, click on the Configuration icon in the product folder to 
reopen the configuration notebook. 



Chapter 9. Installing an OS/2 Distribution Server 71 







72 Quick Beginnings 




Chapter 10. Editing the Base Configuration File 



The first configuration activities you perform on a newly installed TME 10 Software 
Distribution, Version 3.1.5 for OS/2 system are at the distribution server. First, you 
must define it as a target. You then work from it to perform the configuration activities 
required to set up your network. 

Basic distribution server configuration is performed during the installation process and 
the information is stored in the base configuration file. This section describes the 
format of this file and the values that you can enter in its fields. 

The base configuration file, c:\SOFTDIST\nvdm.cfg, contains the system parameters for 
controlling TME 10 Software Distribution, Version 3.1.5 for OS/2. The nvdm.cfg file 
generated at installation does not contain all possible parameters; rather, it contains a 
default subset of them. You can add or remove parameters and change their values by 
editing the file using a text editor. 

The file is stored in a fixed text format. Each line starts with one of the keywords 
described in Table 12. Keywords must be entered in uppercase and followed by a 
colon. Each keyword, except for PROTOCOL, can be used only once. The order of 
keywords in the file is not important, and blank and comment lines can be included. 
Comment lines begin with a number sign character (#). 

To make modifications to the file operative, you must stop and then restart the server 
using the icons in the product folder or the commands: 

nvdm stop 
nvdm start 

Note that if incorrect entries are entered in the base configuration file, the product may 
not start. 



Table 12 (Page 1 of 9). Base Configuration File Parameters 


Keyword 


Description 


API TRACE FILE SIZE 


The maximum size of the TME 10 Software Distribution API 
trace files, in bytes. When the trace file is full, it is 
automatically backed up and a new trace file is started. 

You can change this value but it should not normally be 
necessary. A large value requires more disk space. A small 
value degrades performance very slightly, because the trace 
file is backed up more often. 



© Copyright IBM Corp. 1993, 2000 
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Table 12 (Page 2 of 9). Base Configuration File Parameters 

Keyword Description 

AUTHORIZE This keyword authorizes pull mode clients to install a 

software object or to execute a data file. 

NONE No target is authorized to install a software object 
or to execute a data file unless it is authorized 
through the auth command. 

ALL Any target is authorized to install a software object 
or to execute a data file unless it is unauthorized 
through the unauth command. 

The default is NONE. 

Set the AUTHORIZE keyword as soon as you have installed 

TME 10 Software Distribution, Version 3.1.5 for OS/2. 



AUTOMATIC TARGET This keyword causes clients, when they are added via 

INVENTORY command line or via GUI, to automatically perform a 

hardware and software inventory and store the results in the 
server database. 

Valid values are: 

YES The target inventory is performed when the target is 
added via command line or via GUI 

NO The target inventory is performed only when an 

automatic registration occurs. See the AUTOMATIC 
TARGET REGISTRATION keyword. 

The default is NO. 



AUTOMATIC TARGET This keyword enables clients to automatically register 

REGISTRATION themselves in the server database as one of the server's 

local targets. The registration is performed the first time a 
client connects to the server, if the client is not already 
registered. 

Valid values are: 

YES Enables targets to be registered at the server. 

NO Does not enable targets to be registered at the server. 
The default is NO. 

For automatic registration to be performed, the TARGET 
ADDRESS and TARGET MODE keywords must be set in the 
client's base configuration file, and the CONFIGURATION 
keyword in the client's base configuration file must be 
CLIENT. 

When an automatic target registration is performed an 
inventory is automatically scheduled. 
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Keyword 


Description 


BACKUP AREA 


The name of the directory where software objects are stored 
when they are installed as removable. The default is 
C:\SOFTDIST\BACKUP. If you change the default path, you 
must copy all files into the new path; otherwise change 
control history information is lost. If the default path for the 
backup area is changed, it is not removed automatically if the 
product is uninstalled. 


CONFIGURATION 


The configuration of your TME 10 Software Distribution, 
Version 3.1 .5 for OS/2 node. The name is set up during 
installation and cannot be changed. It can be one of the 
following: 

SERVER NO_COMMS 

Server with no remote connections to other servers 

SERVER WITH_COMMS 

Server with remote connections to other servers 

The value of the field in the distribution server base 
configuration file can be displayed using the Isbs command. 


CONNECTION WINDOW 


The value you specify on this keyword becomes the default 


DURATION 


value for the d option on the connect command. 

It represents the amount of time, in minutes, that the 
connection window from the server to the client is to remain 
open. 

The default value is 60 minutes. 


DACA IDLE TIME 


The time in seconds after which an idle client-server 
connection is considered failed. 

Enter a value from 0 to 32 767. The default is 300. 


DACA RETRY TIME 


The time in seconds before a failed client-server connection 
is retried. 

Enter a value from 0 to 32 767. The default is 600. 
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Keyword 


Description 


FILE SYSTEM 


The name of the file system that the operating system 
supports. Based on this keyword, TME 10 Software 
Distribution chooses the local name when a request provides 
multiple local names. 

The default is one of the following numeric values, depending 
on the operating system: 

1 AIX 

2 OS/2, Windows 3.11, DOS 

3 NetWare 

5 Windows 2000, Windows NT, Windows 98, Windows 95 


INVENTORY PROGRAM 


The name of the program invoked when the inv command is 
issued. It creates the fndswinv file. 


LAN AUTHORIZATION 


Valid entries are: 

0 LAN address authorization is not required. 

1 TME 10 Software Distribution, Version 3.1.5 for OS/2 
validates LAN addresses on all LAN messages received 
by the distribution server. 

If you specify LAN address authorization, you must supply 
the LAN address of each local target. 

The LAN authorization level can be set for individual work 
sessions using the updbs command at the command line 
interface or using the graphical interface. However, if you 
use one of the interfaces to change the value, it is not 
changed in the base configuration file, but is only modified for 
your current work session. 


LOG FILE SIZE 


The maximum size of the TME 10 Software Distribution, 
Version 3.1.5 for OS/2 message log file, in bytes. When the 
log file is full it is automatically backed up, and a new log file 
is started. 

You can change this value but it should not normally be 
necessary. A large value requires more disk space. A small 
value degrades performance slightly, because the log is 
backed up more often. 


MACHINE TYPE 


The operating system in use on your TME 10 Software 
Distribution, Version 3.1.5 for OS/2 node. The name is set 
up during installation and cannot be changed. 


MAX CONNECTIONS 


The maximum number of local targets allowed to process 
requests simultaneously. 

You can specify up to 50 connections. The default is 50. 
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Keyword 


Description 


MAX LOCAL TARGETS 


The total number of local targets that can be configured for a 
server. The maximum number is 2000. The default is 512. 


MAX REQUESTS 


The maximum number of requests that can be active 
simultaneously. 

Enter a value from 1 to 65536. The default is 8192. 


MAX SERVER CONNS 


The maximum number of connections to remote server 
DACAs that can be open simultaneously. These STS 
connections receive requests from remote servers to perform 
operations. The MAX STS keyword, on the other hand, 
defines those STS connections that initiate operations to 
remote servers. 

Enter a value from 0 to 256. The default is 10. 


MAX SERVER TARGETS 


The total number of non-adjacent server targets that can be 
configured for a server. The total includes remote servers 
and single node targets. The MAX SNADS ROUTES and 
MAX STS ROUTES keywords are used to specify the 
number of these targets connected across either SNA/DS or 
STS connections. 

The maximum number is 2048. The default is 10. 


MAX SNADS ROUTES 


The maximum number of SNA/DS connections that can be 
defined. 

The maximum number is 800. The default is 20. 


MAX STS 


The maximum number of STS processes that can be 
simultaneously handling connections to remote distribution 
servers. These STS connections send requests for remote 
servers to perform operations. The MAX SERVER CONNS 
keyword, on the other hand, defines those STS connections 
that receive requests from remote servers. 

Enter a value from 0 to 256. The default is 10. 


MAX STS ROUTES 


The maximum number of STS connections that can be 
defined. 

The maximum number is 1600 minus the number of SNA/DS 
routes that have been defined (MAX SNA/DS ROUTES). 

The default is 30. 
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Keyword 


Description 


MAX TARGETS 


The total number of local and/or remote targets that can be 
configured. The maximum number of targets is 40000. 

This value must be greater than the sum of MAX LOCAL 
TARGETS and MAX SERVER TARGETS. 

The formula MAX TARGETS minus MAX LOCAL TARGETS 
minus MAX SERVER targets determines the number of 
remote targets that can be configured at a server, for which 
there is no keyword in the base configuration file. 

The default for MAX TARGETS is 600. 


MAX USER INTERFACES 


The maximum number of simultaneous GUI and command 
line sessions. The default is 20. 


MESSAGE LOG LEVEL 


This field defines the log level that should be used by 
distribution clients before they establish a connection to the 
distribution server and discover the level configured for them 
there. 

Three log levels are available: 

M Minimal 
N Normal 
D Diagnostic 


PROTOCOL 
Continued overleaf 


A transmission protocol used to communicate with other 
servers and clients. Enter a value using the following syntax: 

<protocol name> <address> 

Where: 

<protocol name> 

Is either TCP (for TCP/IP), IPX, NBI (for NetBIOS), or 
SNA. 
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Keyword Description 

PROTOCOL (Continued) <address> 

If protocol name is TCP, specify: 

TCP hostname portjiumber max_cormections 

If protocol name is NBI, specify: 

NBI NetBIOS_name adapter_number ► 
max_connections 

If protocol name is SNA, specify: 

SNA netid.luname.lumode 
If protocol name is IPX, specify: 

IPX IPX address 

For a server, enter the IPX address using the following 
syntax: 

<internal_network> <server_address> ► 

<socket> 

Where: 

<lnternal_network> is the value reported on the IPX 

Internal Network Number line of the output that you 
receive when you enter the config command on a 
NetWare console. It is 8 characters long. 

<Server_address> is 000000000001 in a NetWare server. 
It is 12 characters long. 

<socket> is 869F for a NetView DM for MVS server. 

The resulting string must be 24 characters long. 

For a client, enter the IPX_address using the following 
syntax: 

<network_ID> <Mac_address> <socket> 

Where: 

<networkJD> is the value reported on the Lan protocol : 
IPX network. . . line of the output that you receive 
when you enter the config command on a NetWare 
console. On an OS/2 workstation it is the value that 
you find in the Lantran.log file. On a Windows NT 
workstation it is the value that you receive when you 
enter the Net config command. It is 12 characters 
long. 

<Mac_address> is the physical address of the card you 
are using. It is 12 characters long. 

<socket> is 869F for a NetView DM for MVS server. 

The resulting string must be 24 characters long. 
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Keyword 


Description 


REPOSITORY 


The name of the repository where TME 10 Software 
Distribution, Version 3.1.5 for OS/2 stores its objects. The 
default repository is c:\SOFTDIST\repos. If the default 
repository path is changed, the repository is not removed 
automatically if the product is uninstalled. 


SERVER 


The system name of this distribution server. It is set up 
automatically on the TME 10 Software Distribution server 
during installation. 

The server name is the text string that identifies the 
workstation name of the server machine. If you do not know 
this name, you can find it by looking at the TME 10 Software 
Distribution server base configuration file. 

If you want to attach a target to other distribution servers, so 
that you are able to administer and configure them, you must 
name those distribution servers here. This keyword can be 
used up to five times. The first instance defines the 
distribution server that provides the distribution server 
function for the distribution client being defined in this table, 
the other instances define distribution servers that can be 
administered from this distribution client. 


SERVICE AREA 


The name of the directory for storing files and information 
pertaining to software objects that require activation. The 
directory should belong to a local file system mounted during 
startup. The default is c:\SOFTDIST\service. If you change 
the default path, you must copy all files into the new path; 
otherwise change control history information is lost. If the 
default path for the service area is changed, it is not removed 
automatically if the product is uninstalled. 


STS IDLE TIME 


The time in seconds after which an idle STS connection is 
considered failed. 

Enter a value from 0 to 32 767. The default is 60. 


STS RETRY TIME 


The time in seconds before a failed STS connection is 
retried. 

Enter a value from 0 to 32 767. The default is 300. 


TARGET PASSWORD 


This keyword activates target password authentication. 


AUTHENTICATION 


Valid values are: 

• YES 

• NO 

The default is NO. 
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Keyword 


Description 


TRACE FILE SIZE 


The maximum size of the TME 10 Software Distribution, 
Version 3.1 .5 for OS/2 internal trace files, in bytes. Two 
trace files are used and when one is full, tracing automatically 
switches to the other. 

You can change this value but it should not normally be 
necessary. A large value requires more disk space. A small 
value degrades performance very slightly, because the log is 
backed up more often. 

Refer to the online Message Reference file for information 
about the TME 10 Software Distribution, Version 3.1.5 for 
OS/2 internal tracing. 


WORK AREA 


The name of the directory where temporary work files are 
created and used. The default is c:\S0FTDIST\work. If the 
default path for the work area is changed, it is not removed 
automatically if the product is uninstalled. 


WORKSTATION NAME 


The name of the workstation that is running your 

TME 10 Software Distribution, Version 3.1.5 for OS/2 node. 

The name is set up during installation and cannot be 

changed. 



Figure 23 on page 82 I s an example of the server base configuration file 
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# BASE CONFIGURATION FILE 




# This file should be stored as 


c:\SOFTDIST\nvdm.cfg 


WORKSTATION NAME: 


serverl 


SERVER: 


serverl 


PROTOCOL: 


TCP srv hostname 729 50 


REPOSITORY: 


C:\SOFTDIST\REPOS 


WORK AREA: 


C:\S0FTDIST\W0RK 


BACKUP AREA: 


C:\SOFTDIST\BACKUP 


SERVICE AREA: 


C:\SOFTDIST\SERVICE 


CONFIGURATION: 


SERVER WITH COMMS 


MESSAGE LOG LEVEL: 


D 


LOG FILE SIZE: 


2000000 


API TRACE FILE SIZE: 


2000000 


TRACE FILE SIZE: 


2000000 


MACHINE TYPE: 


OS/2 


MAX USER INTERFACES: 


20 


MAX ATTEMPTS: 


5 


MAX TARGETS: 


600 


TARGET PASSWORD AUTHENTICATION: 


NO 


AUTHORIZE: 


NONE 


LAN AUTHORIZATION: 


0 


AUTOMATIC TARGET REGISTRATION: 


YES 


DACA RETRY TIME: 


300 



Figure 23. Example of a distribution server Base Configuration File 
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This chapter provides the information needed to define users and targets in a network. 
You can find a complete description of how to define them using the command line 
interface in the online Command Reference for the product. 



Defining Users 

Users are defined at a database at the TME 10 Software Distribution server. A user 
definition includes the user's name and password, a description of the user, and 
security mechanisms that you can use to prevent unauthorized use of product functions 
and safeguard the privacy of sensitive data. They are: 

• The definition of user profiles that enable the user to perform TME 10 Software 
Distribution, Version 3.1.5 for OS/2 functions. The system administrator can define 
profiles to be used by groups of users, or individual profiles for users. Three 
default authorization profiles are installed with the product; FNDADMN for system 
administrators, FNDBLD for change file builders, and FNDUSER for users. 

• The definition of target access keys (TAK) that enable a user to work with specific 
targets. 

• The definition of data access keys (DAK) that enable a user to work with specific 
objects, or data. 

• The definition of the targets the user is authorized to login at 



Defining Targets 

In TME 10 Software Distribution, Version 3.1.5 for OS/2, the term target refers to all 
workstations in a network to which change control and distribution activities are 
directed. The following table contains a description of the parameters you use to define 
targets in a network. 



Table 13 (Page 1 of 7). Target Definition Parameters 


Parameter 


Description 


Name 


Each target in a network has a unique name. When you 
communicate with a target, you use that unique name to 
identify it. A target name can contain up to 63 characters, 
excluding *, ?, and \. 


Description 


Text that describes the target. Up to 59 characters can be 
included in a description. 
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Parameter 


Description 


Change management 


This parameter defines a target's mode. Targets can be 
configured in one of the following modes: 

Push mode 

Change control operations on a push mode target are 
controlled by the administrator at a TME 10 Software 
Distribution server or from a focal or manager target. 

Pull mode 

Change control operations on a pull mode target are 
controlled by the target's user. 

Manager 

A target configured in manager mode can perform 
change control operations on local targets and on remote 
targets. The remote administrator option must be 
installed on managers. Only targets whose type is server 
or single can be configured in manager mode. More 
than one target can be defined as a manager in a 
network. 

Focal 

A target configured in focal mode is a focal point for 
targets that define it as such. This means that the 
defining target routes all change control operation reports 
(both local and remote) to it. A focal target also acts as 
a manager. Only targets whose type is server or single 
be configured in focal mode. 
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Parameter 


Description 


Target address 


The address you assign to a target must be unique in its 
domain, and can be up to 8 alphanumeric characters long. 

For remote communication, the address of each target must 
be unique across the entire network. A complete address is 
composed of two parts, one of which is the target address 
you define here. The terminology used for the two parts of 
the address is different depending on the platform it runs on: 

• ForTME 10 Software Distribution, Version 3.1.5 for 
OS/2 targets the terminology is the same as that used 
here. A complete target address is expressed as: 

<server name>.<target address> 

If a target is a TME 10 Software Distribution server, both 
its <server name> and its ctarget address> must be the 
same. 

In SNA environments, these terms are also referred to 
as: 

crouting group name>.<routi ng element name> ► 
(RGN.REN) 

• For NetView DM for MVS and NetView DM/2 targets, the 
complete name is composed of: 

cNetwork I D> . <LU name> 

Thus the ctarget address> entered in this field must 
correspond to a target's LU name. 

In most organizations, target names are allocated from a 
central authority (at the host processor) because this is the 
name to which change control instructions are sent. In a 
large network, it is often impossible to make this field 
meaningful. You may need to resort to the use of digits to 
produce unique names. If you are adding a remote target, its 
name must already be defined at the remote site. 

The address of a local target forms part of the global file 
name of files that are cataloged automatically for a target. 
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Parameter 


Description 


Target type 


A target must be one of the following types: 

Client 

Targets connected to a TME 10 Software Distribution 
server which have a TME 10 Software Distribution Client 
program installed. 

Clients can be either local or remote targets. Those in 
the same CC domain as their TME 10 Software 
Distribution server are referred to as local targets. 

Clients that belong to a different TME 10 Software 
Distribution domain are referred to as remote targets. 
Remote targets must be configured at all 
TME 10 Software Distribution servers they are to 
exchange files or change control requests with. Change 
control operations can be performed on remote targets 
only if the remote administration product option is 
installed on your system. 

Clients can be defined in push mode or pull mode. 

Clients can also be configured, or registered 
automatically, the first time they connect to a server. 
Seel“Automatic Client Reaistration” on oaqe 891 

Server 

Targets running TME 10 Software Distribution, Version 
3.1 .5 for OS/2 and which have the server option installed. 
TME 10 Software Distribution servers can perform 
change control and distribution operations on 
TME 10 Software Distribution clients in their software 
distribution domain. If they have the remote 
administrator product option installed, they can perform 
operations on remote targets. 

Server targets can be configured in push, pull, manager 
or focal mode. 
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Parameter 


Description 


Target type (cont.) 


Single 

Targets running TME 10 Software Distribution, Version 
3.1 .5 for OS/2 configured as a base system. Single-node 
targets can be used as preparation sites for software or 
as focal points to receive reports of change control 
operations. They can be configured in pull, push, 
manager or focal mode. 

Single-node targets can be accessed over TCP/IP and 
SNA/DS (APPC) networks. Change control operations 
can be performed on them if the remote administration 
option is installed on your system. 

Use this type also to define a NetView DM for MVS 
target. 

User Interface only (Ul only) target 

Targets that can be used to run the TME 10 Software 
Distribution, Version 3.1.5 for OS/2 user interfaces. This 
type of target is useful when you have an environment in 
which more than one TME 10 Software Distribution 
server exists. It allows an administrator (a user 
belonging to the FNDADMN user group) to access all 
TME 10 Software Distribution servers from the same 
target either to perform administrative tasks or to 
schedule distributions to targets. 

A workstation configured in this manner is used to initiate 
change control on other targets, or to request 
distributions to and from the TME 10 Software 
Distribution server. User interface only targets cannot 
receive change control instructions from the same 
TME 10 Software Distribution server for which they are 
defined. 

You cannot define change control modes for Ul only 
targets. 
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Parameter 


Description 


Target OS 


The type of operating system installed on the target. It can 
be one of the following: 

AIX 

DOS 

HP_UX 

MAC 

NCR 

NETWARE 

OS/2 

SCO 

SINIX 

SOLARIS 

SUNOS 

WINDOWS (for Windows 3.11) 

WIN95 (for Windows 95) 

WIN98 (for Windows 98) 

WINDOWSJMT 

WIN2K (for Windows 2000) 


Access key 


The key that allows users to access the target. A user can 
access a target only if he or she has been assigned the 
same access key as the one assigned to the target. Target 
access keys are defined by the system administrator. 


LAN address 


The target's bumed-in LAN address. This parameter must be 
defined if the Validate LAN function is set to on. When it is 
on, if the target attempts to communicate with a 
TME 10 Software Distribution server, a check is performed 
to verify whether the LAN address stored in the target's 
database matches its actual address. 

The Validate LAN function can be set at either a 
TME 10 Software Distribution server or a target workstation. 
To change the setting from a target, the LAN address must 
already be defined in the database of the target. 

If you are adding a Ul target only, a target's LAN address is 
automatically captured at the target itself, and stored at the 
TME 10 Software Distribution server. Leave this field blank, 
unless you need to change the automatically captured 
address. 


Server name 


For a client target, the name of the TME 10 Software 
Distribution server to which the target is linked. 
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Parameter 


Description 


Domain address 


This parameter is required for remote targets. The ID can be 
up to 8 characters long. The only valid characters are 
uppercase alphabetics and numerics. The value you define 
depends on the type of target you are defining: 

TME 10 Software Distribution, Version 3.1.5 for OS/2 
Server or Single Node 

Specify the target address specified for the target. 

Client Specify the server name of the TME 10 Software 
Distribution server to which the client is connected. 

Non TME 10 Software Distribution, Version 3.1.5 for OS/2 
target 

If the target you are defining is not a 
TME 10 Software Distribution, Version 3.1.5 for 
OS/2 target, specify, for NetView DM/2 and 
NetView DM for MVS nodes, the Network ID of the 
remote network to which this target belongs. This 
value corresponds to the routing group name 
(RGN) part of the SNA/DS address of the target. 
Ask the administrator at the host processor what 
the value is. 


Password 


The password used to access the target. It can have from 6 
to 8 characters. 



Automatic Client Registration 

System administrators do not have to configure all client targets in a network 
individually at a server. They can be configured automatically, or autoregistered, the 
first time a client target connects to a server. For autoregistration to take place, the 
AUTOMATIC TARGET REGISTRATION keyword in a server's base configuration file 
must be set to YES (see |Table 12 on page 73j , and the TARGET ADDRESS and 
TARGET MODE keywords must be specified in the client base configuration file (see 
the Installation and Configuration manual for the TME 10 Software Distribution Clients). 

When a client is automatically configured, its address and mode are inserted in the 
server database. Any other parameters for the client target must be specified manually 
using the graphical interface or the command line interface. 

Automatic configuration is performed at all remote servers connected in a linear 
hierarchy to the first server that registers the target, as long as AUTOMATIC TARGET 
REGISTRATION is set to YES in each server's database. However, automatic target 
registration information is not routed from TME 10 Software Distribution, Version 3.1.5 
for OS/2 servers to NetView DM/2 servers or NetView DM for MVS focal points. 
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Chapter 12. Configuring for Communication with MVS 



Configuring Advanced Program to Program Communications with NetView DM for MVS 
implies configuring the communication subsystems required to support this type of link. 
This means that you must configure the following: 

• Personal Communications/Communications Server APPC connection on the 
TME 10 Software Distribution server 

• VTAM and NCP definitions at the MVS site 

• NetView DM for MVS customization 



The next sections explain how to configure these subsystems. 



Remember that you can take advantage of the APPC Confi guration SmartGu ide, 
available online, to help you with some of these tasks. See “Using the APPC 



Configuration SmartGuides to Connect Over SNA” on page 66| for more information 



Configuring Personal Communications/Communications Server 

You configure Personal Communications or Communications Server either through the 
respective user interfaces or through a response file to obtain a working APPC 
connection with NetView DM for MVS. 

You can also use the APPC Configuration SmartGuide. The SmartGuide creates your 
Personal Communications/Communications Server configuration in an easy way. See 
Fusing the APPC Configuration SmartGuides to Connect Over SNA” on page 66| for 
more information or try the APPC Configuration SmartGuide in the TME 10 Software 
Distribution for OS/2 Server window. 

This section shows a sample Personal Communications node definition file for 
establishing a connection to NetView DM for MVS. The sample is organized and 
labeled by section for easier reading. 
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Defining the Local Control Point Profile 

DEFINE_LOCAL_CP FQ_CP_NAME (ITIBM0PC . PPE0539 ) 

DESCRI PTION (Physi cal Unit 539) 

CP_ALIAS (PPE0539 ) 

NAU_ADDRESS(INDEPENDENT_LU) 

NODE_TYPE(EN) 

N0DE_ID(X 1 05D00539 1 ) 

NW_FP_SUPPORT(NONE) 

H0ST_FP_SUPP0RT (YES) 

HOST_FP_LINK_NAME (HOST00O1) 

MAX_C0MP_LEVEL(N0NE) 

MAX_C0MP_T0KENS (0) ; 

Defining the Logical Link Profile 

DEFINE_LOGICAL_LINK LINKJAME(HOSTOOOl) 

DESCRIPTION(Connection to Host) 
FQ_ADJACENT_CP_NAME(ITIBMOPC .MVSESA31) 
ADJACENT_NODE_TYPE(LEN) 

DLC_NAME ( I BMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATION_ADDRESS (X 1 400015701088 1 ) 
ETHERNET_F0RMAT(N0) 

C P_C P_S ESS 1 0N_S U P P0 RT (NO) 

SOLI C I T_SSCP_SESS ION (YES) 

N0DE_ID(X 1 05D00539 1 ) 

ACTIVATE_AT_STARTUP(NO) 

USE_PUNAME_AS_CPNAME (NO) 

LIMITED_RESOURCE ( US E_ADAPT ER_DE F I N I T I ON ) 

LI NK_STAT I 0N_R0LE ( US E_ADAPT ER_DE F I N I T I ON ) 

MAX_ACTIVATION_ATTEMPTS(USE_ADAPTER_DEFINITION) 

EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION) 

COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 

COST_PER_BYTE(USE_ADAPTER_DEFINITION) 

SECURITY (USE_ADAPTER_DEFINITION) 
PR0PAGATI0N_DELAY ( US E_ADAPT ER_DE F I N I T I ON ) 
USER_DEFINED_1 (USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_3(USE_ADAPTER_DEFINITI0N) ; 

Defining the Local Logical Unit 

DEFINE_LOCAL_LU LU_NAME(LT0539A0) 

LU_ALI AS ( LT0539A0) 

NAU_ADDRESS(INDEPENDENT_LU) ; 
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Defining the Partner Logical Unit Profile 

DEFINE_PARTNER_LU FQ_PARTNER_LU_NAME ( ITI BMOPC . CTNDM15G) 
PARTNER_LU_ALIAS(CTNDM15G) 
PARTNER_LU_UNINTERPRETED_NAME(CTNDM15G) 
MAX_MC_LL_SEND_SIZE (32767) 

CON V_S ECU R I TY_V ERI FICATION(NO) 
PARALLEL_SESSION_SUPPORT (NO) ;2 

Defining the Partner LU Location Profile 

DEFINE_PARTNER_LU_LOCATION FQ_PARTNER_LU_NAME (ITI BMOPC. CTNDM15G) 

WI LDCARD_ENTRY (NO) 

FQ_0WN ING_CP_NAME ( I T I BMO PC . MVS ESA3 1 ) 
LOCAL_NODE_NN_SERVER(NO) ; 



Defining the Mode Profile 

DEFINE_MODE M0DE_NAME(LU62 ) 

COS_NAME(#CONNECT) 

DEFAULT_RU_SIZE(NO) 

MAX_RU_SIZE_UPPER_B0UND(4096) 

RECEIVE_PACING_WIND0W(4) 

MAX_NEGOTIABLE_SESSION_LIMIT (32767) 

PLU_MODE_SESSION_LIMIT (1)3 

MIN_CONWINNERS_SOURCE(0) 

PACING_TYPE(FIXED) 

COMPRESS 1 0N_NEED( PROHIBITED) 

P LU_S LU_COMPRESS I ON (NONE) 

SLU_PLU_COMPRESSION (NONE) ; 

Defining the TME 10 Software Distribution TP for Inbound Transmissions 

DEFINE_TP SNA_SERVICE_TP_NAME (X 1 21 ' ,008) 

PI P_ALL0WED (NO) 

FI LESPEC (I: \IBMSDS2\BIN\FNDTC.EXE) 

C0NVERSATI0N_TYPE (EITHER) 

C0NV_SECURITY_RQD(N0) 

SYNC_LEVEL( EITHER) 

TP_OPERATION(QUEUED_AM_STARTED) 

PR0GRAM_TYPE (BACKGROUND) 

INC0MING_ALL0CATE_QUEUE_DEPTH(255) 

I NCOM I NG_ALL0CATE_T I MEOUT (INFINITE) 
RECEIVE_ALLOCATE_TIMEOUT (INFINITE) ; 



2 Note that Parallel Session Support must be set to NO for NetView DM for MVS sessions. 

3 Note that for MVS sessions the Mode Session Limit must be set to 1. 
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Defining the TME 10 Software Distribution TP for Outbound Transmissions 

DEFINE_TP SNA_SERVICE_TP_NAME (X 1 21 ' ,007) 

PI P_ALL0WED (NO) 

FI LESPEC (I: \IBMSDS2\BIN\FNDTC.EXE) 

CONVERSATION_TYPE (EITHER) 

CONV_SECURITY_RQD (NO) 

SYNC_LEVEL( EITHER) 

TP_OPERATION(QUEUED_AM_STARTED) 

PROGRAM_TYPE (BACKGROUND) 

INC0MING_ALL0CATE_QUEUE_DEPTH(255) 

INC0MING_ALL0CATE_TIME0UT (INFINITE) 

RECEI VE_ALL0CATE_TIME0UT (INFINITE); 

Starting the Attach Manager 

START_ATTACH_MANAGER; 



Defining Targets for Communication with MVS 

To define a NetView DM for MVS system as a focal point, enter the following 
command: 

nvdm addtg ctarget name> -s ctarget address> 

-b server -m focal -n <domain address> 



For example, enter: 

nvdm addtg CTNDM154 -s CTNDM154 -n ITIBMOPC -m focal -b server 

To define a TME 10 Software Distribution, Version 3.1.5 for OS/2 target at MVS, on 
the GIX Define Node panel enter the following information. Note that the <domain 
address> and the <target address> to be inserted respectively in the Rgn and Ren 
fields are the same value. 



1 


Node class . 


AO 


Requi red 




2 


Status . . . 


2 


1 = Production 2 = Parallel 3 = Test 




3 


Logical unit 


LT0539AC 


Required (Logical unit name) 




4 


Logon mode . 


LU62 


Logon mode name 




5 


Linetype . . 


1 


1 = Leased 2 = Switched 




6 


Rgn 


<domain 


address> Network identification 




7 


Ren 


<target 


address> CP Logical unit name 




8 


Notes . . . 


2 


Enter 1 if you want additional node info 




9 


Profile. . . 


2 


Enter 1 if you want to change node profile 




10 


Server name. 


<target 


address> Server name 




11 


Timzoffs . . 


+00 


Time Zone offset. Any value from -12 to 12 


V 



Figure 24. Defining a TME 10 Software Distribution, Version 3. 1.5 for OS/2 node at MVS 
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Configuring at the NetView DM for MVS Site 

This section describes the configuration procedures you must perform to enable 
communication between a TME 10 Software Distribution server and NetView DM for 
MVS. 



Configuring NCP and VTAM 

To define a TME 10 Software Distribution node to VTAM, you need to work with your 
NetView DM for MVS system administrator to agree on naming conventions. You need 
to: 



Define the TME 10 Software Distribution physical and logical units (see “Physical 
land Logical Unit Definitions”] . 



Define the parameters in a logon mode table for the sessions between the NetView 



DM for MVS system and TME 10 Software Distribution (see |“Logon Mode Table 
iDefinition” on page 103j . 



Examples are shown in the following section, but they do not provide an exhaustive 
definition of how to configure VTAM and NCP. Consult your VTAM Resource Definition 
Reference where necessary. 



Physical and Logical Unit Definitions 

Each TME 10 Software Distribution that is connected directly to NetView DM for MVS 
(that is, not through an intermediate node) requires an independent LU to be defined to 
VTAM and also to NCP if it is being used. A physical unit is also required for any 
intermediate node that provides a connection to a TME 10 Software Distribution node. 

The following sections provide examples of configuring direct connections. They are for 
the following configurations: 

• Connection to a 3745 attached to the LAN {“Connection through a 3745 Gateway”! 

• Connection through a token-ring gateway ( [“Connection through a Token-Ring 
iGateway” on page 97| 

• Direct con nection using an SDLC link ^“Direct Connection Using an SDLC Link” onl 
page 100] 

In addition, an example of a logon mode table is shown. You can use this table for any 
of the three sample configurations. 

The APPC Configuration SmartGuide provides personalized configurations for these 
types of connections, in addition to a connection through a 3172 VTAM gateway 
attached by token-ring or Ethernet. 



Connection through a 3745 Gateway 

This section gives the NCP and VTAM definitions necessary for TME 10 Software 
Distribution to commun icate with NetView DM for MVS through a 3745 gateway. See 
Figure 25 on page 96 
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Figure 25. TME 10 Software Distribution and NetView DM for MVS using a direct link and a 3745 



NCP Definition for Token-Ring Connection: The statements in Figure 26 show the 
NCP macros used to define the connectivity to the token ring and the PU/LU pairs 
required to support devices on a switched line. (TME 10 Software Distributions on a 
LAN token ring are supported as devices on a switched line.) 



T027TRPG 

T027TRL1 

T027TRP1 

LUTIC2 

T027TRG1 



GROUP ECLTYPE=PHYSICAL 

LINE ADDRESS=( 1092 , FULL) , L0CADD=4Q0037271092 , P0RTADD=1 
RCVBUFC=4095,MAXTSL=1108,TRSPEED=16,ADAPTER=TIC2 
PU ADDR=Q1,PUDR=N0,ANS=C0NT 

LU L0CADDR=0, 1 STATUS=I NACT I V E 

GROUP ECLTYPE=L0GICAL, AUT0GEN=24, PHYP0RT=1 ,CALL=IN0UT 



Figure 26. NCP macros for Token-Ring connectivity 
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VTAM Switched Major Node Definitions: The statements in Figure 27 show the 
VTAM macros used to define the switched major node containing the PU and LU 
statements for the TME 10 Software Distribution node. 

Note that L0CADDR=Q indicates an independent LU. 



DIALNMD6 VBUILD TYPE=SWNET,MAXGRP=2,MAXN0=2 

NDM6PU PU ADDR=C1 , IDBLK=071 , IDNUM=O0G13 , PUTYPE=2 , ISTATUS=ACTIVE, 

DL0GM0D=NVDMN0RM,USSTAB=TP0USS,MAX0UT=7 ,MAXDATA=265, * 
PAC I NG=0 , VPAC I NG=0 , ANS=C0NT , M0DETAB=NDMLU62P 

NDM6LU LU L0CADDR=0 , M0DETAB=NDMLU62 P , DL0GM0D=NVDMI\I0RM , 
ISTATUS=ACTIVE 



Figure 27. VTAM macros for TME 10 Software Distribution connectivity 

TME 10 Software Distribution Definitions: Table 14 shows the correspondence 
between VTAM and TME 10 Software Distribution parameters. 



Table 14. VTAM and TME 10 Software Distribution Parameters, 3745 Connection 


VTAM Parameter 


TME 10 Software Distribution Parameter 


NETID=NETWK1 


Network name 


IDNUM=00013 


Node ID 


DLOGMOD=NVDMNORM 


Mode name 


PU=NDM6PU 


PU name 


LU=NDM6LU 


LU name for TME 10 Software Distribution 


LOCADDR=0 


Indicates that this is an independent LU 


LOCADD=400037271 092 (NCP 
parameter) 


The address that is specified in the Personal 
Communications link definition 



Connection through a Token-Ring Gateway 

This section gives the 3174 and NCP/VTAM definitions necessary for 

TME 10 Software Distribution to communicate with NetView DM for MVS through a 

token-ring gateway. See jFigure 28 on page 98| 
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Figure 28. TME 10 Software Distribution and NetView DM for MVS using a Token-Ring gateway 



The gateway can be any proprietary software or it can be a 3174. Instructions for 
configuring the gateway are not given here; refer to the documentation provided with 
the gateway. 

NCP/VTAM Definitions: IFigure 29 on page 99| shows sample NCP/VTAM definitions. 
They refer to the network shown in Figure 28. 
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GSDLC 



L002 



GWPU 



GWLU 



NDM6PU 



NDM6LU 



Figure 29. 



GROUP CLOCKNG=EXT, 
DIAL=N0, 
LNCTL=SDLC, 
REPLYTO=0 . 5 , 
RETRIES=(19,4,5) , 
TYPE=NCP 

LINE ADDRESS=002 , 
DUPLEX=FULL, 
ETRATI0=25, 
SPEED=960O, 
ISTATUS=ACTIVE, 
RETRIES=(7,2,2) 

PU ADDR=C0, 

ISTATUS=ACTIVE, 
PACING=(1) , 
PUDR=YES, 
PUTYPE=2, 

D I SCNT=( NO) 

LU L0CADDR=1, 

ISTATUS=ACTIVE, 

M0DETAB=TP0M0DE, 

DL0GM0D=SD82 

PU ADDR=C1 , 

MAXDATA=265, 

MAX0UT=7 , 

PASSLIM=8, 

PUTYPE=2, 

SSCPFM=USSSCS, 

XID=YES 

LU LOCADDR=0, 

ISTATUS=ACTIVE, 

M0DETAB=NDMLU62P, 

DL0GM0D=NVDMN0RM, 

RESSCB=2, 

PAC I NG=1 



l /TAM and NCP macros for connectivity through a gateway 
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The definition in Figure 29 contains the following: 

• A PU for the gateway (GWPU) 

• An LU for 3270 use at the gateway (GWLU) 

• A PU for the TME 10 Software Distribution node using the same line as that used 
to reach the gateway (NDM6PU) 

• An independent LU for the TME 10 Software Distribution node (NDM6LU) 

Note that this LU is defined under the PU for the TME 10 Software Distribution 
node. The LU has LOCADDR=0 to indicate an independent LU. 

TME 10 Software Distribution Definitions: Table 15 shows the correspondence 
between VTAM and TME 10 Software Distribution parameters. 



Table 15. VTAM and TME 10 Software Distribution Parameters, Token-Ring Gateway 
Connection 


VTAM Parameter 


TME 10 Software Distribution Parameter 


NETID=NETWK1 


Network name 


DLOGMOD=NVDMNORM 


Mode name 


PU=NDM6PU 


PU name 


LU=NDM6LU 


LU name for TME 10 Software Distribution 


ADDR=C1 


Local station address 



Direct Connection Using an SDLC Link 

This section gives examples of the NCP and VTAM definitions necessary for a 
TME 10 Software Distribution node to communicate with NetView DM for MVS over a 
direct SDLC link. See lFiqure 30 on page 1 01 1 
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NetView 
Distribution 
Manager Host 




SDLC 




Software 

Distribution Server 

PU=NDMIPU 

LU=NDMILU 




Software 

Distribution Client 



Software 

Distribution Client 



Figure 30. SDLC connection to NetView DM for MVS 



NCP/VTAM Definition: Fi gure 31 on page 102| shows sample NCP/VTAM definitions. 
They refer to the network shown in Figure 30. 
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GSDLC GROUP CL0CKNG=EXT, 

DIAL=N0, 
LNCTL=SDLC, 
REPLYTO=0.5, 
RETRIES=(19,4,5) , 
TYPE=NCP 

L002 LINE ADDRESS=0O2, 

DUPLEX=FULL, 

ET RAT 1 0=2 5, 
SPEED=9600, 
ISTATUS=ACTIVE, 
RETRIES=(7,2,2) 

NDM6PU PU ADDR=C1, 

MAXDATA=265, 
MAX0UT=7 , 
PASSLIM=8, 
PUTYPE=2 , 
SSCPFM=USSSCS, 
XID=YES 

NDM6LU LU L0CADDR=0, 

ISTATUS=ACTIVE, 

M0DETAB=NDMLU62P, 

DL0GM0D=NVDMN0RM, 

RESSCB=2, 

PAC I NG=1 



Figure 31. VTAM and NCP macros for connectivity using an SDLC link 



The definition in Figure 31 contains the following: 

1. A direct attachment on line L002 to the PU for the TME 10 Software Distribution 
node (NDM6PU) 

2. An independent LU (L0CADDR=0) for access to the TME 10 Software Distribution 
node defined directly under the PU (NDM6LU). 



TME 10 Software Distribution Definitions: [Table 16 on page 103| shows the 
correspondence between VTAM and TME 10 Software Distribution. 
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Table 16. VTAM and TME 10 Software Distribution Parameters, SDLC Connection 


VTAM Parameter 


TME 10 Software Distribution Parameter 


NETID=NETWK1 


Network name 


DLOGMOD=NVDMNORM 


Mode name 


PU=NDM6PU 


PU name 


LU=NDM6LU 


LU name for TME 10 Software Distribution 


ADDR=C1 


Local station address 



Logon Mode Table Definition 

The logon mode table is used to define the parameters for sessions between 

TME 10 Software Distribution and NetView DM for MVS. This table defines the logon 

mode NDMLU62P that is referred to in all the previous examples. 



MODETAB 

NDMLU62P MODEENT L0GM0DE=NVDMN0RM, 

FMPR0F=X 1 13 1 , 

TSPR0F=X'07 1 , 

PRIPR0T=X ' BQ 1 , 

SECPR0T=X 1 BQ : 1 , 

C0MPR0T=X' 50A1 1 , 

ENCR=B'00OO\ 

RUS I ZES=X 1 8585 1 , 

PSNDPAC=X 1 03 1 , 

SRCVPAC=X 1 03 1 , 

SSNDPAC= 1 00 1 , 

PS ERV I C=X 1 060200000000000000002400 1 , 
TYPE=X ' 0 1 , 

C0S=C0SNAME 

M0DEEND 



Figure 32. Logon mode table 

The parameters in Table 17 are specific for defining the LU session between 
TME 10 Software Distribution and NetView DM for MVS. 



Table 17 ( Page 1 of 5). Parameters for Defining the LU Session 


Parameter 


Description 


LOGMODE 


Specifies the entry name that is used to point to the set of 
session parameters in this logon mode table. 

You can use any entry name with up to eight characters; 
however, this must match the mode name specified within 
the configuration for TME 10 Software Distribution. 
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Table 17 (Page 2 of 5). Parameters for Defining the LU Session 


Parameter 


Description 


FMPROF 


Specifies the function management profile for this entry. Set 
FMPROF to X ' 1 3 1 , which indicates that Function 
Management Profile 19 (X 1 13') rules are to be used for 
these LU 6.2 sessions. See Systems Network Architecture 
Formats. 


TSPROF 


Specifies the transmission services profile for this entry. Set 
TSPROF to X'07', which indicates that Transmission 
Services Profile 7 (X'07') rules are to be used for these LU 
6.2 sessions. See Systems Network Architecture Formats. 


PRIPROT 


Specifies the primary LU protocols for this entry. Set 
PRIPROT to X'BO', which indicates the following protocols 
are to be used: 




• Multiple RU chaining 

• Immediate request mode 

• Definite or exception response. 


SECPROT 


Specifies the secondary LU protocols for this entry. Set 
SECPROT to X'BO 1 . 


COMPROT 


Specifies the common LU protocols for this entry. Set 
COMPROT to X'50A1 which indicates that the following 
protocols are to be used: 




• Segmenting 

• FMFI allowed 

• Brackets used 

• CEB used 

• No alternate code set 

• BIND RSP not held 

• HDX-FF 

• Symmetric recovery 

• SLU=winner 

• HDX-FF reset is SEND for PLU and RCV for SLU 


ENCR 


Specifies the type of cryptography to be used with the VTAM 
data encryption facility. Set ENCR to B 1 B0000 1 , that is, no 
cryptography because VTAM does not support encryption for 
LU 6.2 sessions. 
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Table 17 (Page 3 of 5). Parameters for Defining the LU Session 


Parameter 


Description 


RUSIZES 


Specifies the maximum length of data (request units or RU) 
in bytes that can be sent by the primary LU and the 
secondary LU when they are in session with each other. 

RUSIZES is represented by four hexadecimal digits. The 
two leftmost digits apply to the secondary LU and the two 
rightmost digits apply to the primary LU. The format is the 
same for both sets of digits: in each set, the first digit is the 
mantissa (m) and the second digit is the exponent (n) in the 
formula m x 2 n . The mantissa must be in the range 
X'S'-X'F 1 . The exponent must be in the range X'O'-X'F 1 . 

This formula is then used to calculate the maximum RU 
sizes that can be sent by the primary or secondary LU. For 
example, RUSIZES=X'858C' specifies that the secondary 
LU can send an RU of maximum length 8 x 2 5 (or 256) 
bytes and the primary LU can send an RU of maximum 
length 8 x 2 C (or 32768) bytes. 

TME 10 Software Distribution supports all RU sizes. 
Flowever, you should note the following guidelines when 
setting up the logon mode table and when configuring 
Personal Communications: 

• Small RUs make poor use of your data transfer 
mechanism. Transfer times, especially for large files, 
are considerably increased by using small RUs. The 
smallest RU size that you should consider is 256 bytes. 

• Large RUs can cause saturation at the receiver if the 
data cannot be processed as fast as it is received. 

• Some SNA connections, especially slow ones like public 
telecommunication lines, are better suited to small RUs 
(for example 256 or 512 bytes). 

• TME 10 Software Distribution supports any legal RU 
size between 256 and 3840 bytes. Any BIND proposing 
a size smaller than 256 is rejected by TME 10 Software 
Distribution; any BIND proposing a size greater than that 
configured is negotiated downward. 
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Table 17 (Page 4 of 5). Parameters for Defining the LU Session 


Parameter 


Description 




Therefore, RUSIZES is best set to X'F8F8' (4 KB) 
maximum and X'8585' (256 bytes) minimum. For a 
TME 10 Software Distribution node connected directly 
through a token ring to a channel-attached NCP, an RU size 
of 3840 is expected to be optimal. For other attachments, 
link speeds and connectivity must be considered when you 
are selecting the optimal value. 




NetView DM for MVS does not check the RUSIZES value for 
NetView DM for MVS-to-TME 10 Software Distribution 
sessions. In the sample logmode definition, RUSIZES is set 
to X'8585' (256 bytes) for NetView DM for MVS sessions. 
These values should be consistent with those defined to the 
TME 10 Software Distribution node. 


PSNDPAC 


Specifies the primary send pacing count. This value is not 
checked by TME 10 Software Distribution. If PSNDPAC is 
omitted, PSNDPAC=X'00' is the default. 


SRCVPAC 


Specifies the secondary receive pacing count. If SRCVPAC 
is omitted, SRCVPAC=X'00' is the default. 




SRCVPAC must be appropriate to the RU size selected for 
the primary LU, and is determined by the formula: 




(2n - 1) x primary send RU size <= 4KB 




where n is the SRCVPAC value. 




For example, SRCVPAC=X'01 ' if the two rightmost digits of 
RUSIZES are X ' F7 ' . If the RUSIZES chosen is X ' 8585 ' , 
SRCVPAC can be as high as X'08‘. 




The value of SRCVPAC greatly influences throughput. 
Higher values of this parameter ensure better throughput. 
Set SRCVPAC as high as the calculation allows. 




Note that SRCVPAC can be negotiated downward but never 
upward. 


SSNDPAC 


Specifies the secondary send pacing count. 

TME 10 Software Distribution has no dependencies on this 
value. It is used as specified. SSNDPAC=X'00' is the 
default. 
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Table 17 (Page 5 of 5). Parameters for Defining the LU Session 


Parameter 


Description 


PSERVIC 


Specifies the presentation services profile for this entry. Set 
PSERVIC to X' 060200000000000000002400' which 
indicates that the following will be used: 




• LU 6.2 

• No attach security 

• Sync level=confirm 

• PLU reinitiates 

• Parallel sessions are not supported. 


TYPE 


Specifies the type of BIND command for this entry. Set 
TYPE to X 1 0 ' , which means that the secondary LU can 
support a negotiable BIND. 


COS 


Specifies the name of an entry in a class of service table to 
be used for sessions established with this logon mode. 
Because it is a batch mode, you should use an entry that 
specifies low-priority virtual routes so as not to interfere with 
interactive traffic. 



Configuring NetView DM for MVS 

NetView DM for MVS requires two specific customization steps to manage 
TME 10 Software Distribution nodes. 

1 Define node types with change management entry point (CMEP) functional 
capabilities for TME 10 Software Distribution TME 10 Software Distribution 
servers. 

You can use the APPC Configuration SmartGuide to obtain these definitions. 

You do not have to define the TME 10 Software Distribution clients. They define 
themselves automatically when TME 10 Software Distribution is installed. 

2 When NetView DM for MVS has been configured to manage this type of node, 
prepare the specific network definition for both directly and indirectly connected 
nodes. 

If a node type with CMEP functional capabilities has not been defined, then you must 
perform a new run of the installation macros. 

Prepare the following for the NetView DM for MVS stage 1 installation job: 

• NDMNODE 

• NDMTCP 

• NDMCP 

• A transmission profile 

Prepare a macro defining the characteristics for a TME 10 Software Distribution server. 
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In NetView DM for MVS, specify a node type for TME 10 Software Distribution servers 
and declare it to have change management entry point (CMEP) functional capabilities. 

In the example in Figure 33, the node type for TME 10 Software Distribution servers 
has been assigned the name NDM6. 

Now prepare the following macros: 

1 An NDMNODE macro to define a node type with CMEP functional capabilities for 
TME 10 Software Distribution nodes (see Figure 33). 



NDMNODE TYPE=NDM6, 

L0GM=NVDMN0RM , FUNC=CMEP , 

XMFUNC=(SEND, RETR, DELE), 

RESTYPE=(0060, 0070, 0080, 0100, 0120, 0220, 0230, 0240, 0250) 



Figure 33. Sample NDMNODE macro for TME 10 Software Distribution Server 

The variables defined are shown in Table 18. 



Table 18 (Page 1 of 2). NDMNODE Variables 


Parameter 


Description 


LOGM 


Set this value to the name of a logon mode table that 
defines the session parameters for communication between 
TME 10 Software Distribution and NetView DM for MVS. 
(Refer to the example in IFiqure 32 on paqe 1031) 


FUNC 


The functional capability must be defined as CMEP. 

A CMEP node can manage changes to itself and has limited 
ability to manage changes to other nodes. 


XMFUNC 


This can be set to (SEND, RETR, DELE) for a 
TME 10 Software Distribution node. 

This parameter defines the transmission-function 
authorization parameters. That is, it defines those functions 
that the TME 10 Software Distribution nodes are allowed to 
initiate against NetView DM for MVS. TME 10 Software 
Distribution nodes support sending, retrieving, and deleting 
files but cannot initiate change control commands. 
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Table 18 (Page 2 of 2). NDMNODE Variables 


Parameter 


Description 


RESTYPE 


This parameter gives the data object classifications that the 
TME 10 Software Distribution node is authorized to work 
with. TME 10 Software Distribution can work with all of the 
defined resource types, so you should list them all unless 
you have some reason to limit the types of files that you 
want a particular node to have permission to transfer. 

This parameter must be present if the XMFUNC parameter is 
specified. Refer to the NetView DM for MVS Installation and 
Customization Guide for possible values. 


SFUNC 


This parameter lists the functions that may be issued to the 
TME 10 Software Distribution node. The default is the full 
set (SEND, RETR, DELE, REMO, ACTI, IN IT, ACCE, INST, 
UNIN). 

This parameter need not be specified, because 
TME 10 Software Distribution supports all of the functions. 
To limit the functions that can be issued by NetView DM for 
MVS to a particular node, you must use this parameter and 
specify only those functions that are allowed. 



2 An NDMTCP macro specifically for the TME 10 Software Distribution application. 
A sample macro highlighting the lines that are significant for TME 10 Software 
Distribution is shown in jFigure 34 on page 110[ 
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NDMTCP APPLID=(RAKADTQ3,*) , 


IAPPLID=(RAKADI03 ,*) , 


IPLUNAM=N0NE, 


(LU NAME OF DEFAULT IOF PRINTER) 


OPCTL=NETV, 


(SELECTED MESSAGES ARE ROUTED TO NV) 


R0UTCD1=2 , 




R0UTCD2=2 , 




DSCD1=6, 




DSCD2=6, 




RESWAIT=300, 


(SECONDS NDM WAITS FOR LU62 RESPONSE) 


STALI NE=1 , 


(DEFAULT IS NO) 


AUT0STR=N0, 


(NO IS THE DEFAULT) 


AUT0END=N0, 


(NO IS THE DEFAULT) 


RETRY=3, 


(RETRY COUNT FOR INTERRUPTED SESSION) 


RETINT=30, 


(TIME WAITED BY TCP BEFORE A RETRY) 


APPC=YES, 


(YES IF NDM IS TO HAVE LU6.2 SESSION) 


MAXTASK=(4, 1) , 


(CONCURRENT SESSION TOTAL, SWITCHED SESS) 


SWDLY=5, 


(SECS. WAITED BEFORE VTAM SESSION RETRY) 


SWRTRY=3, 


(NUMBER OF VTAM SESSION RETRIES) 


DDPREQ=YES, 


(FORCED TO YES IF APPC=YES) 


RESYNCH=4, 


(4098K BYTE BLOCKS BETWEEN CHECKPOINTS) 


MSGINF0=2, 


(ALL MSGS GO TO SYSPRINT/IOF/CONSOLE) 


H0PCNT=5, 


(NO. OF NODES AN LU6.2 MSG. CAN HOP) 


AUTEXIT=NDMEXIT, 


(USER-EXIT TO POINT TO RACF FOR IOF) 


NDCCAPI=NO, 


(DO NOT HAVE API FEATURE INSTALLED) 


QMSURPT=NO, 


(DEFAULT. YES IF U HAVE USER APPLS) 


S U F F I X= 1 8 





Figure 34. Sample NDMTCP macro for TME 10 Software Distribution 



The significant parameters are described in Table 19. 



Table 19 (Page 1 of 2). NDMTCP Parameters 


Parameter 


Description 


RESWAIT 


Defines the number of seconds NetView DM for MVS waits 




for a response from a TME 10 Software Distribution node. 


APPC 


This must be set to YES to indicate that APPC is in use. 
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Table 19 (Page 2 of 2). NDMTCP Parameters 


Parameter 


Description 


HOPCNT 


A distribution is passed from node to node across the SNA 
network. Each time it is passed is called a hop. 

The hop count is the maximum number of hops that can be 
included in a single routing chain from NetView DM for MVS. 
The distribution must reach its destination within this number 
of hops. 

This parameter is provided to prevent messages looping 
forever in large networks with conflicting routing instructions 
at different nodes. In simple networks, assign this parameter 
a small number. 



3 An NDMCP macro to define connection profiles that group LU 6.2 logical units 
that have the same attributes and connection capabilities. 

If your TME 10 Software Distribution workstation is connected by a line that 
allows the workstation to establish a session (for example, a leased line): 

a Define a connection profile with the polling parameter set to NO. 

b Assign the LU name of the TME 10 Software Distribution workstation to 
that connection profile. 

In this way, TME 10 Software Distribution will not poll for a reply for a 
host-initiated request. An example is shown in Figure 35. 



NDMCP CPNAME=CP02, 
P0LLING=N0 



Figure 35. Example of an NDMCP macro 

4 A transmission profile that groups nodes to connect them to the central site using 
the same type of line. Grouping nodes in this way optimizes line usage. For 
example, if a multipoint line is used to connect eight nodes, they could be 
grouped by a transmission profile that specifies that no more than three 
concurrent transmissions can take place against them, ensuring better load 
balancing across different lines. 

Each transmission profile can have its own retry specifications. 

An example of the NDMTP customization macro that is used to define a 
transmission profile is shown in Figure 36. 



NDMTP TPNAME=TPNDM2,TPTYPE=L,MINGR=27,MAXN=50 



Figure 36. Example of an NDMTP macro 
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where: 

• TPNAME is the name of the transmission profile 

• TPTYPE specifies the connection type of the nodes (in this example, a 
leased line) 

• MINGR specifies the number of transmission tasks that the TCP can grant to 
the transmission profile 

• MAXN specifies the maximum number of transmission tasks that can be 
active at the same time 
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i Chapter 13. Configuring Personal 
i Communications/Communications Server 



This chapter includes sample output files for Personal Communications 4.x 
configurations: 

• For a SNA/DS connection between a TME 10 Software Distribution for OS/2 
server and another TME 10 Software Distribution for OS/2 server, a 

TME 10 Software Distribution for AIX server, or a TME 10 Software Distribution 
for Windows NT server ([“Configuration for a SNA/DS Connection”) 

• For an STS connection between a TME 10 Software Distribution for OS/2 server 
and another TME 10 Software Distribution for OS/2 server, a TME 10 Software 
Distribution for OS/2 clien t, or a TME 10 Software Distribution for AIX server 
[“Configuration for an STS Connection using APPC” on page 1 1 6| 

• For an APPC connection between an TME 10 Software Distribution for OS/2 client 
and a TME 10 Software Distribution for OS/2 or TME 10 Software Distribution for 
AIX server ( [“Configuration for an APPC Connection on a Client” on page l T8j > at 
the client 

For information about confi guring Personal Communications for communication with 
NetView DM for MVS , see [“Configuring P ersonal Communications/Communicationsl 
Server” on page 91 



Configuration for a SNA/DS Connection 

This section shows sample output files for connecting a TME 10 Software Distribution 
for OS/2 server to a TME 10 Software Distribution for OS/2, TME 10 Software 
Distribution for AIX, or TME 10 Software Distribution for Windows NT server over 
SNA/DS. 

Defining the Local Control Point Profile 

DEFINE_L0CAL_CP FQ_CP_NAME ( I T I BMOPC . PPE0539 ) 

DESCRIPT I ON (Physical Unit 539) 

CP_ALIAS (PPE0539 ) 

NAU_ADDRESS ( I NDEPENDENT_LU) 

NODE_TYPE(EN) 

N0DE_ID(X 1 05DO0539 1 ) 

NW_FP_SUPPORT (NONE) 

HOST_FP_SUPPORT(YES) 

HOST_FP_LINK_NAME (HOSTO001) 

MAX_COMP_LEVEL(NONE) 

MAX_C0MP_T0KENS (0) ; 
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Defining the Logical Link Profile 

DEFINE_LOGICAL_LINK L I NK_NAME (LIN KO0O2) 

FQ_ADJACENT_CP_NAME(ITIBMOPC . PPE0541 ) 
ADJACENT_NODE_TYPE(LEN) 

DLC_NAME ( I BMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATION_ADDRESS (X 1 10O05AAFA37304 ' ) 
ETHERNET_FORMAT(NO) 

C P_C P_S ESS 1 0N_S U P PO RT (NO) 

SOLI C I T_SSCP_SESS ION (NO) 

N0DE_ID(X 1 05D0O539 1 ) 

ACTIVATE_AT_STARTUP(YES) 

USE_PUNAME_AS_CPNAME (NO) 

LI M I TED_RESOURC E ( US E_ADAPT ER_D E F I N I TI ON) 

LI NK_STAT I 0N_R0LE ( US E_ADAPT ER_DE F I N I T I ON ) 

MAX_ACTIVATION_ATTEMPTS(USE_ADAPTER_DEFINITION) 

EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION) 

COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 

COST_PER_BYTE(USE_ADAPTER_DEFINITION) 

SECURITY (US E_ADAPTER_DE FI N I T I ON) 
PROPAGATION_DELAY ( US E_ADAPT ER_DE F I IM I T I ON ) 
USER_DEFI NED_1 ( US E_ADAPTER_DE F I NIHON) 
USER_DEFINED_2(USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_3(USE_ADAPTER_DEFINITI0N) ; 



Defining the Local LU Profile 

DEFINE_LOCAL_LU LU_NAME(LT0539A0) 

LU_ALI AS ( LT0539A0) 

NAU_ADDRESS(INDEPENDENT_LU) ; 

Defining the Partner LU Profile 

DEFINE_PARTNER_LU FQ_PARTNER_LU_NAME ( ITIBMOPC . LT0541AO) 
PARTNER_LU_ALI AS ( LT0541A0) 
PARTNER_LU_UNINTERPRETED_NAME(LT0541AO) 
MAX_MC_LL_SEND_SIZE (32767) 

CON V_S ECU R I TY_V ERI FICATION(NO) 
PARALLEL_SESSION_SUPPORT (YES) ; 

Defining the Partner LU Location Profile 

DEFINE_PARTNER_LU_LOCATION FQ_PARTNER_LU_NAME(ITIBM0PC. LT0541A0) 

WILOCARD_ENTRY (NO) 

FQ_OWNING_CP_NAME ( ITIBMOPC . PPE0541 ) 
LOCAL_NODE_NN_SERVER(NO) ; 
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Defining the Mode Profile 

DEFINE_MODE M0DE_NAME(LU62 ) 

COS_NAME(#CONNECT) 

DE FAU LT_RU_S I Z E ( NO) 
MAX_RU_SIZE_UPPER_B0UND(4096) 
RECEIVE_PACING_WIND0W(4) 
MAX_NEGOTIABLE_SESSION_LIMIT (32767) 

P LU_M0DE_S ESS 1 0N_L I MIT (2)* 
MIN_CONWINNERS_SOURCE(0) 

PAC I NG_TYPE (FIXED) 

COMPRESS 1 0N_NEED( PROHIBITED) 

P LU_S LU_COMPRESS I ON (NONE) 
SLU_PLU_COMPRESSION(NONE) ; 

‘Note that any value can be inserted here for non-MVS nodes. 



Defining the SNA Server TP for Inbound Transmissions 

DEFINE_TP SNA_SERVICE_TP_NAME(X'21 1 ,008) 

P I P_A LLOWED (NO) 

FI LESPEC (I: \SOFTDIST\BIN\FNDTC.EXE) 
CONVERSATION_TYPE (EITHER) 
CONV_SECURITY_RQD(NO) 

SYNC_LEVEL( EITHER) 
TP_OPERATION(QUEUED_AM_STARTED) 
PROGRAM_TYPE (BACKGROUND) 
INC0MING_ALL0CATE_QUEUE_DEPTH(255) 

I NCOMI NG_ALLOCATE_T IMEOUT (INFINITE) 
RECEIVE_ALLOCATE_TIMEOUT (INFINITE) ; 

Defining the SNA Server TP for Outbound Transmissions 

DEFINE_TP SNA_SERVICE_TP_NAME (X 1 21 ' ,007) 

P I P_A LLOWED (NO) 

FI LESPEC (I: \SOFTDIST\BIN\FNDTC.EXE) 
C0NVERSATI0N_TYPE (EITHER) 
C0NV_SECURITY_RQD(N0) 

SYNC_LEVEL( EITHER) 
TP_0PERATI0N(QUEUED_AM_STARTED) 
PR0GRAM_TYPE (BACKGROUND) 
INC0MING_ALL0CATE_QUEUE_DEPTH(255) 

I NCOMI NG_ALL0CATE_T IMEOUT (INFINITE) 
RECEIVE_ALLOCATE_TIMEOUT (INFINITE) ; 

Starting the Attach Manager 

START_ATTACH_MANAGER; 
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Configuration for an STS Connection using APPC 

If you are connecting a TME 10 Software Distribution for OS/2 server to another 
TME 10 Software Distribution for OS/2 server, or a TME 10 Software Distribution for 
AIX server using STS, this sample file configures Personal Communications at both 
OS/2 servers. (The sample for one server is provided. Specify the same data at the 
partner server, providing the appropriate values.) 

If you are connecting an OS/2 server to a TME 10 Software Distribution for OS/2 client 
or a TME 10 Software Distribution for AIX server using STS, this sample file configures 
Personal Communicati ons at the server workstation. A sample file to configure the 
OS/2 clien t is given in [“Configuration for an APPC Connection on a Client” on| 
page 118 



Defining the Local Control Point Profile 

DEFINE_L0CAL_CP FQ_C P_NAME ( I T I BMOPC . I9RLW0DZ) 
CP_ALIAS ( I9RLWXXX) 
NAU_ADDRESS( INDEPENDENT^) 
NODE_TYPE(EN) 

N0DE_ID(X ' 05D001F7 1 ) 
NW_FP_SUPP0RT(N0NE) 
H0ST_FP_SUPP0RT (YES) 
HOST_FP_LINK_NAME (H0STG001) 
MAX_COMP_LEVEL(NONE) 
MAX_C0MP_T0KENS (0) ; 
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Defining the Logical Link Profile 

DEFINE_LOGICAL_LINK LIN K_NAME (LI NK0001 ) 

FQ_ADJACENT_CP_NAME(ITIBMOPC . I9RLW06X) 
ADJACENT_NODE_TYPE( LEARN) 

DLC_NAME ( I BMTRNET ) 

ADAPTER_NUMBER(Q) 

DESTINATION_ADDRESS (X 1 1 0005 AAFA0 1504 ' ) 
ETHERNET_FORMAT(NO) 

CP_CP_SESSION_SUPPORT (NO) 
ACTIVATE_AT_STARTUP(NO) 

LIMITED_RESOURCE ( US E_ADAPTER_DE E I N I T I ON ) 

LIN K_STAT 1 0N_R0LE ( US E_ADAPTER_DE F I N I T I ON ) 

SOLI C I T_SSC P_SESS ION (NO) 

MAX_ACTIVATION_ATTEMPTS(USE_ADAPTER_DEFINITION) 
USE_PUNAME_AS_CPNAME (NO) 

EFFECTIVE_CAPACITY ( US E_ADAPT ER_D E F I N I T I ON ) 

COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 

COST_PER_BYTE(USE_ADAPTER_DEFINITION) 

SECURITY (USE_ADAPTER_DEFINITION) 
PROPAGATION_DELAY ( US E_ADAPTER_DE F I N I T I ON ) 
USER_DEFINED_1 (USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_3(USE_ADAPTER_DEFINITI0N) ; 

Defining the Local Logical Unit 

DEFINE_LOCAL_LU LU_NAME(I9RLW0ZD) 

LU_ALIAS ( I9RLW0ZD) 

NAU_ADDRESS ( I NDEPENDENT_LU) ; 

Defining the Partner Logical Unit 

DEFINE_PARTNER_LU FQ_PARTNER_LU_NAME(ITIBMOPC. I9RLW06X) 
PARTNER_LU_ALI AS ( I9RLW06X) 
PARTNER_LU_UNINTERPRETED_NAME(I9RLW06X) 
MAX_MC_LL_SEND_SIZE (32767) 

C0NV_S ECU R I T Y_V ERI FICATION (NO) 
PARALLEL_SESSION_SUPPORT (YES) ; 

Defining the Partner LU Location Profile 

DEFINE_PARTNER_LU_LOCATION FQ_PARTN ER_LU_NAME ( I T I BMO PC . I9RLW06X) 

WILDCARD_ENTRY (NO) 

FQ_0WN I NG_CP_NAME ( I T I BM0PC . I9RLW06X) 
L0CAL_N0DE_NN_SERVER(N0) ; 
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Defining the Mode Profile 

DEFINE_MODE M0DE_NAME(LU62 ) 

C0S_NAME(#C0NNECT) 

D E FAU LT_RU_S I ZE ( NO) 

MAX_RU_SIZE_UPPER_B0UND(4096) 

RECEI VE_PACING_WINDOW (63) 
MAX_NEGOTIABLE_SESSION_LIMIT (32767) 

P LU_M0DE_S ESS 1 0N_LI M I T (1) 

MIN_C0NWINNERS_S0URCE(0) 

COMPRESS 1 0N_NEED( PROHIBITED) 

PLU_SLU_C0MPRESSI0N (NONE) 

SLU_PLU_COMPRESSION (NONE) ; 

Defining the Personal Communications Default Values 

DEFINE_DEFAULTS I MP L I C I T_I NB0UND_P LU_SU PPORT ( Y ES ) 
DEFAULT_M0DE_NAME(LU62) 
MAX_MC_LL_SEND_SIZE(32767) 
DIRECTORY_FOR_INBOUND_ATTACHES (*) 
DEFAULT_TP_OPERATION(NONQUEUED_AM_STARTED) 
DEFAULT_TP_PROG RAM_T Y P E ( B AC KG ROUND) 
DEFAULT_TP_CONV_SECURITY_RQD(NO) 
MAX_HELD_ALERTS(10) ; 

Defining the SNA Server TP for Inbound and Outbound Transmission 

DEFINE_TP TP_NAME(NVDM) 

PI P_ALL0WED (NO) 

FI LESPEC (C:\SOFTDIST\BIN\FNDSCHD. EXE) 
CONVERSATION_TYPE(ANY_TYPE) 

C0NV_SECURITY_RQD(N0) 

SYNC_LEVEL( EITHER) 

TP_OPERATION(QUEUED_AM_STARTED) 

PROGRAM_TYPE (BACKGROUND) 
INC0MING_ALL0CATE_QUEUE_DEPTH(255) 
INC0MING_ALL0CATE_TIME0UT (INFINITE) 

RECEI VE_ALL0CATE_TIME0UT (INFINITE); 

Starting The Attach Manager 

START_ATTACH_MANAGER; 



Configuration for an APPC Connection on a Client 

This sample file configures Personal Communications at the client workstation. 
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Defining the Local Control Point Profile 

DEFINE_LOCAL_CP FQ_C P_NAME ( I T I BMOPC . I9RLW06X) 

CP_ALIAS ( I9RLW06X) 

NAU_ADDRESS ( I NDEPENDENT_LU) 

NODE_TYPE(EN) 

N0DE_ID(X ' 05D00OF9 1 ) 

NW_FP_SUPPORT(NONE) 

H0ST_FP_SUPP0RT (YES) 

HOST_FP_LINK_NAME (HOSTOOOl) 

MAX_C0MP_LEVEL(N0NE) 

MAX_C0MP_T0KENS (0) ; 

Defining the Logical Link Profile 

DEFINE_LOGICAL_LINK L I N K_NAME ( HOSTO0O 1 ) 

ADJACENT_NODE_TYPE(LEN) 

DLC_NAME ( I BMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATION_ADDRESS (X 1 400010390000 1 ) 
ETHERNET_F0RMAT(N0) 

C P_C P_S ESS 1 0N_S U P P0 RT (NO) 

SOLI C I T_SSC P_SESS ION (YES) 

N0DE_ID(X ' 05D000F9 1 ) 

ACTIVATE_AT_STARTUP(N0) 

USE_PUNAME_AS_CPNAME (NO) 

LIMITED_RES0URCE ( US E_ADAPTER_DE F I N I T I ON ) 

LIN K_STAT 1 0N_R0LE ( US E_ADAPTER_DE F I NIHON) 
MAX_ACTIVATI0N_ATTEMPTS(USE_ADAPTER_DEFINITI0N) 
EFFECTIVE_CAPACITY ( US E_ADAPT ER_D E F I N I T I ON ) 
C0ST_PER_C0NNECT_TIME(USE_ADAPTER_DEFINITI0N) 
C0ST_PER_BYTE(USE_ADAPTER_DEFINITI0N) 

SECURITY (USE_ADAPTER_DEFINITI0N) 
PR0PAGATI0N_DELAY ( US E_ADAPTER_DE F I N I T I ON ) 
USER_DEFINED_1 (USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_2(USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_3(USE_ADAPTER_DEFINITI0N) ; 

DEFINE_L0GICAL_LINK LINK_NAME(LINK0002) 

FQ_ADJACENT_CP_NAME(ITIBM0PC . I9RLW0DZ) 
ADJACENT_NODE_TYPE(LEN) 

DFC_NAME ( I BMTRNET) 

ADAPTER_NUMBER(0) 

DESTINATI0N_ADDRESS (X 1 10005AAEDCF7 1 ) 
ETHERNET_F0RMAT(N0) 

C P_C P_S ESS 1 0N_S U P P0 RT (NO) 

SOLI C I T_SSC P_SESS ION (YES) 
ACTIVATE_AT_STARTUP(N0) 

USE_PUNAME_AS_CPNAME (NO) 
LIMITED_RES0URCE(USE_ADAPTER_DEFINITI0N) 



Chapter 13. Configuring Personal Communications/Communications Server 119 




Configuration for an APPC Connection on a Client 



LI NK_STAT I 0N_R0LE ( US E_ADAPT ER_DE F I N I T I ON ) 

MAX_ACTIVATION_ATTEMPTS(USE_ADAPTER_DEFINITION) 

EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION) 

COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION) 

COST_PER_BYTE(USE_ADAPTER_DEFINITION) 

SECURITY (USE_ADAPTER_DEFINITION) 
PROPAGATION_DELAY ( US E_ADAPT ER_DE F I N I T I ON ) 
USER_DEFINED_1 (USE_ADAPTER_DEFINITION) 
USER_DEFINED_2(USE_ADAPTER_DEFINITI0N) 
USER_DEFINED_3(USE_ADAPTER_DEFINITI0N) ; 

Defining the Partner Logical Unit Profile 

DEFINE_PARTNER_LU FQ_PARTNER_LU_NAME(ITIBMOPC. I9RLW0DZ) 
PARTNER_LU_ALI AS (I9RLW0DZ) 
PARTNER_LU_UNINTERPRETED_NAME(I9RLW0DZ) 
MAX_MC_LL_SEND_SIZE (32767) 

CON V_S ECU R I TY_V ERI FICATION(NO) 
PARALLEL_SESSION_SUPPORT (YES) ; 

Defining the Partner LU Location Profile 

DEFINE_PARTNER_LU_LOCATION FQ_PARTNER_LU_NAME(ITIBMOPC. I9RLW0DZ) 

WI LDCARD_ENTRY (NO) 

FQ_OWNING_CP_NAME ( I T I BMOPC . I9RLW0DZ) 
LOCAL_NODE_NN_SERVER(NO) ; 



Defining the Mode Profile 

DEFINE_MODE M0DE_NAME ( LU62 ) 
COS_NAME(#CONNECT) 

DE FAU LT_RU_S I ZE ( NO) 
MAX_RU_SIZE_UPPER_BOUND(4096) 

RECE I V E_PAC I NG_W I NDOW (63) 

MAX_N EGOT I ABLE_SESS 1 0N_LI MI T (32767 ) 
P LU_M0DE_S ESS 1 0N_LI M I T (8) 4 
MIN_C0NWINNERS_S0URCE(0) 

COMPRESS 1 0N_NEED( PROHIBITED) 

P LU_S LU_COMPRESS I ON (NONE) 

S LU_P LU_COMPRESS I ON (NONE) ; 



4 It is recommended that the mode profile define a minimum number of sessions of at least 8. This is necessary because multiple 
processes on the client require separate sessions to communicate with the server. 
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Defining the Personal Communications Default Values 

DEFINE_DEFAULTS I MP L I C I T_I NB0UND_P LU_SU P PORT (YES) 
DEFAULT_MODE_NAME (BLANK) 
MAX_MC_LL_SEND_SIZE(32767) 
DIRECTORY_FOR_INBOUND_ATTACHES(*) 
DEFAULT_TP_OPERATION(NONQUEUED_AM_STARTED) 
DEFAULT_TP_PROGRAM_TYPE (BACKGROUND) 
DEFAULT_TP_CONV_SECURITY_RQD(NO) 
MAX_HELD_ALERTS(10) ; 

Defining the SNA Server TP for inbound and Outbound Transmission 

DEFINE_TP TP_NAME(NVDM) 

P I P_A LLOWED (NO) 

FI LESPEC (d:\SOFTDIST\BIN\fndcmps.exe) 

PARM_STRING(SNA) 

CONVERSATION_TYPE (EITHER) 

CONV_SECURITY_RQD(NO) 

SYNC_LEVEL( EITHER) 

TP_OPERATION(QUEUED_AM_STARTED) 

PROGRAM_TYPE(FULL_SCREEN) 

INC0MING_ALL0CATE_QUEUE_DEPTH(255) 

I NCOMI NG_ALLOCATE_T IMEOUT (INFINITE) 
RECEIVE_ALLOCATE_TIMEOUT (INFINITE) ; 

Starting the Attach Manager 

START_ATTACH_MANAGER; 
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Chapter 14. Configuring STS Remote Connection Files 



This chapter describes how to configure the connection files required to define an STS 
(Server-to-Server) network using APPC, TCP/IP, IPX, or NetBIOS connections. You 
need to edit this configuration information when you define or update STS connections 
to remote nodes. 



Editing STS Connection Configuration Files 

The configuration information for STS connections is in three text files, which can be 
edited using a text editor. 

The files are: 

STS configuration file 

This file contains the system parameters for controlling TME 10 Software 
Distribution, Version 3.1.5 for OS/2's use of the STS network implemented 
across APPC, TCP/IP, IPX, or NetBIOS connections. 

STS connection configuration files 

This file contains the details of an APPC, TCP/IP, IPX, or NetBIOS 
connection to an adjacent node. 

Routing table 

This file instructs the distribution server which APPC, TCP/IP, IPX, or 
NetBIOS connection should be used use when distributions are sent to 
remote targets. 

If you edit one of these files while TME 10 Software Distribution, Version 3.1.5 for 
OS/2 is running, you must use the rid command to reload configuration changes. 

STS Configuration File 

The STS configuration file, <product_dir>\db\snadscfg, contains a parameter for 
controlling the use that TME 10 Software Distribution, Version 3.1.5 for OS/2 makes of 
the STS network, ORIGIN HOP COUNT. 

There can be only one configuration file at a distribution server. Your network may 
include both STS and SNA/DS connections. An SNA/DS connection file can contain 
other keyword s in addition to ORIGIN HOP COUNT (see |“SNA/DS Configuration File”| 
Ion page 133) . If you have a mixed network, specify all the keywords in a single file. 

You only need to edit this file when performing system tuning, and access is usually 
restricted to the administrator. 

The file is stored with a fixed text format. Enter the keyword once, in uppercase 
characters, and end it with a colon. Blank and comment lines can be included. 
Comment lines begin with a number sign (#). 
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Table 20. STS Configuration File Parameters 


Keyword 


Description 


ORIGIN HOP COUNT 


The default hop count to be used for distributions originated 
by TME 10 Software Distribution, Version 3.1.5 for OS/2 
when the hop count is omitted or is specified as zero in the 
routing table. (See|“Editinq the STS Routinq Table” on| 
Ipage 1261) An appropriate value for this field is 5. 



Figure 37 is an example of the STS Configuration File. 



# STS CONFIGURATION FILE 

# 

# This file should be stored as <product_di r>\db\snadscfg 
ORIGIN HOP COUNT: 10 

Figure 37. Example of an STS Configuration file 



STS Connection Configuration File 

STS connection configuration files define the details of APPC, TCP/IP, IPX, or NetBIOS 
connections to adjacent nodes. Each file is given the name of the connection it 
defines. Up to 800 connection configuration files can be defined, while up to 100 
connections can be active simultaneously. 

The files are stored in the directory <product_dir>\db\snadscon, where <product_dir> 
is the directory where the product was installed. A sample file, called defconft, is 
provided for STS connections via TCP/IP;. 

Access is usually restricted to the administrator. The sample connection configuration 
file is provided in the <product_dir> directory. 

Each file is stored with a fixed text fo rmat. Each line starts with one of the keywords 
described in lTable 21 on page 1 25l Enter each keyword in uppercase and end it with 
a colon. 

Each keyword can be used only once. The order of the keywords is not important, and 
blank and comment lines can be included. Comment lines begin with a number 
sign (#). 
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Table 21. STS Connection Configuration File Parameters 


Keyword 


Description 


PROTOCOL 


Specify 


either: 




APPC 


The APPC protocol is used. 




TCP/IP 


The TCP/IP protocol is used. 




IPX 


The IPX protocol is used. 




NBI 


The NetBIOS protocol is used. 


TYPE 


STS 


For an STS (server-to-server) connection type. 


REMOTE SERVER NAME 


The workstation name of the remote server. 



Figure 38 is an example of an STS connection configuration file for the TCP/IP 
connection protocol. This sample file, called DEFCONFT, is installed during product 
installation. 



# STS CONNECTION CONFIGURATION 


FILE FOR CONNECTION defconft 


# This connection is used to handle transmissions between 


# TME 10 Software Distribution, 

# across TCP/IP. 


Version 3.1.5 for OS/2 servers using STS 


# This file should be stored as 


<product_di r>\db\snadscon\defconft 


PROTOCOL: 


TCP/IP 


TYPE: 


STS 


REMOTE SERVER NAME: 


remote_wks_name 



Figure 38. Example of an STS Connection Configuration File for TCP/IP 



iFiqure 39 on page 126 i s an example of an STS connection configuration file for the 
APPC connection protocol. 
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# STS CONNECTION CONFIGURATION 


FILE FOR CONNECTION 


TT 

# This connection is used to handle transmissions between 


# TME 10 Software Distribution, 

# APPC across STS. 


Version 3.1.5 for OS/2 servers using 


f 

# This file should be stored as 


<product_di r>\db\snadscon\defconfa 


PROTOCOL: 


APPC 


TYPE: 


STS 


REMOTE SERVER NAME: 


sts_server 



Figure 39. Example of an STS Connection Configuration File for APPC 



Editing the STS Routing Table 

This section describes how to define the connections in the STS routing table. 

The routing table is an editable text file that tells the TME 10 Software Distribution, 
Version 3.1.5 for OS/2 server which APPC, TCP/IP, IPX, or NetBIOS connection to use 
when sending a distribution to a remote target. Set up this table to reference the 
connections that you have configured for your system. A routing table can contain up 
to 1600 entries. 

You do not need to configure a routing table if you do not have remote communication 
configured. You only need to edit it when you add a new remote connection, or when 
you want to tune a complex network by careful matching of routes and connections. 

A sample routing table is set up for you when you configure remote communication 
during installation. The file is <product_dir>\db\roiitetab, where <product_dir> is the 
directory where the product was installed. You need to change this table to define 
routes. 

The routing table contains the definition of the network ID for the distribution server and 
for each of the distribution clients in a network. It also defines a number of routes. 

Each route has the following data associated with it: 

• Protocol type: APPC, TCP/IP, IPX, NetBIOS, or BOTH (meaning APPC and all 
other protocol types) 

• Addresses of the targets reached by this route 

• The name of the connection to use 

• The hop count to use on distributions sent on this route. 



126 



Quick Beginnings 





Editing the STS Routing Table 



Planning a Simple Routing Table 

In a simple configuration, your distribution server is attached to just one remote node. 
Only one connection is defined and this takes all distributions to and from the 
distribution server. 

You need only configure a single route. The SNA/DS address should be given as *.* 
to allow any SNA/DS name to be routed. If included, set the connection service 
parameters to show that any value is supported on the connection. 

Planning a Complex Routing Table 

Plan a complex routing table with care. Remember that a distribution is sent on the 
first route in the table that meets the requirements of the distribution. You should, 
therefore, put specific SNA/DS addresses before generic ones, and restricted 
connections before all-purpose ones. 

You may find it helpful to draw a diagram of your connections to adjacent NetView DM 
nodes before you start. In your diagram, you can put the SNA/DS addresses of the 
remote targets reached through each node, and the services offered by each 
connection. 

The diagram helps you ensure that distributions are routed to the correct destinations, 
and that no distribution is unexpectedly rejected because there is no connection 
capable of carrying it. 

If you have a busy system, you can reserve some connections for handling small, 
high-priority distributions. This prevents them from being held up until active, large 
distributions complete. You can do this by setting the priority and capacity service 
parameters on the reserved connections. 

Determining Destination Addresses 

Routes in your routing table must identify the destination target of the link being 
defined. A target is identified by two values: 

• Its domain address 

• Its target address 

These two values are separated by a period (.) and are expressed in this format in 
routes in the routing table: 

<domain address>.<target address> 

In SNA terminology, these values correspond to: 
crouting group name>.<routing element name> 

which is commonly expressed as: 

<RGN>.<REN> 
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The two values are referred to using different terms on the various platforms that can 
be included in a TME 10 Software Distribution network. To identify a target's <domain 
address> and <target address> look for the corresponding terms shown in Table 22. 



Table 22. Target Identification Terms 


Type of Target 


Domain address 


Target address 


NetView DM for MVS 


Network ID * 


LU name * 


NetView DM/2 


Network ID 


LU name 


TME 10 Software Distribution Server 


domain address 


target address 



Note: * In a NetView DM for MVS-controiled network, the network ID is the same as the 
network ID defined for the NetView DM for MVS system it is part of. The LU name uniquely 
identifies the node within that network. You can find out what this is by contacting the 
administrator at that site. You set the local network ID just once. This value is picked up for 
the RGN of all local nodes. 



Defining Routes 

Before defining the routes in a routing table, the type of network you are defining must 
be specified. Specify one of the following values for the NETWORK PROTOCOL 
keyword at the beginning of the routing table: 

APPC APPC routes are being defined. 

TCP/IP TCP/IP routes are being defined. This is the default value, even if this 
keyword is not included in the routing table. 

BOTH APPC and TCP/IP are being defined in the routing table. 

NetBIOS NetBIOS routes are being defined. 

IPX IPX routes are being defined. 



Each route is defined by exactly one line in the routing table. Lines in a routing table 
can be any length. Blank lines are permitted between routes in the routing table. 
Comment lines begin with a number sign character (#). 

Note: In an STS network, if you do not need an SNA/DS connection, do not select 
either APPC or BOTH (APAR 1111831), even if your STS connection uses APPC, to 
avoid running the Transmission Control Program unnecessarily. Instead, use whichever 
of the other protocols is used by the clients in in the LAN. 



Enter the information in Table 23 on page 129 



in the order shown, to define a route. 
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Table 23. Defining Routes in a Routing Table 



Parameter 


Description 


Destination Address 


The destination nodes that this route serves. 

TME 10 Software Distribution, Version 3.1.5 for OS/2 
searches the table for an entry matching the destination of 
each distribution that it sends. If no match is found, a 
distribution report is generated and returned to the originator 
of the distribution. 

Enter the address in the form: 

<domain address>.<target address> 

Each value can be up to eight characters long. The 
characters must be either uppercase letters, numbers, or the 
special characters @, #, and $. For example NETWK1 . LU0001. 

You can use the asterisk (*) and question mark (?) as 
wildcard characters. 

See|“Determininq Destination Addresses” on paqe 127|for 
additional information. 


Connection Name 


The connection name for this route. This name relates to the 
STS connection configuration file that you create under the 
<product di r>\db\snadscon directory (see|“Editing STS| 
iConnection Configuration Files” on page 1 23k. For 
consistency this name can be the host name of the system 
you are connecting to. 


Hop Count 


This parameter defines the hop count for all distributions sent 
out using this route. It indicates the maximum number of 
nodes that the distribution can legitimately pass through 
before reaching its destination. The hop count prevents 
distributions from looping between nodes in the network with 
contradictory routing tables. 

Enter the hop count as a decimal digit. Set the value to one 
if the next node on this route is an end node. If you are 
unsure of the topology of your network, set the field to 5. 

Flop count can be omitted from a routing table. If it is not 
defined, the value defaults to the one defined for Origin Flop 
Count in the SNA/DS configuration file (see|“STSI 
IConfiauration File” on oaae 1231. 


Sample routing tables follow. 


They are supplied with TME 10 Software Distribution, 



Version 3.1.5 for OS/2 in the <product_di r>\db\routetab file. The comment line 
containing the column headings for the configuration information is included to facilitate 
reading. 
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# STS ROUTING TABLE 

# This table provides STS routing information for 

# APPC routes. 



# This file should be stored 


as \<product_di r>\db\routetab 


NETWORK PROTOCOL: 


: APPC 




f 

# Destination 


Connection 


Hop 


# address 

# 




Count 


SRVSNA1.* 


C0NNSNA1 


5 


SRVSNA2.* 


C0NNSNA2 


5 


* , * 


C0NNSNA3 


5 



Figure 40. Example of an STS Routing Table for APPC routes 

Figure 41 is an example of an STS routing table for TCP/IP routes. 



# STS ROUTING TABLE 

# This table provides STS routing information for 

# TCP/IP routes. 

# This file should be stored as \<product_di r>\db\routetab 



NETWORK PROTOCOL: 


: TCP/IP 




# 

# Destination 


Connection 


Hop 


# Address 

# 




Count 


SRVTCP1.* 


C0NNTCP1 


10 


SRVTCP2.* 


C0NNTCP2 


10 


* . * 


C0NNTCP3 


10 



Figure 41. Example of an STS Routing Table for TCP/IP routes 

Fig ure 42 on page 1 31 1 is an example of an STS routing table for APPC, TCP/IP, IPX, 
and/or NetBIOS routes. 
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# STS ROUTING TABLE 

# This table provides STS routing information for 

# APPC, TCP/IP, IPX, and NetBIOS routes. 

# This file should be stored as \<product_di r>\db\routetab 



NETWORK PROTOCOL: 


BOTH 




# 


# Destination 

# Address 

# 


Connection 


Hop 

Count 


SRVSNA1 .* 


C0NNSNA1 


10 


SRVSNA2.* 


C0NNSNA2 


10 


* . * 


C0NNSNA3 


10 


NETWK1.H0ST 


C0NNSNA4 


10 


SRVTCP1.* 


C0NNTCP1 


10 


SRVIPX2.* 


C0NNIPX2 


10 


SRVNBI3 .* 


C0NNNBI3 


10 



Figure 42. Example of an STS Routing Table for APPC, TCP/IP, IPX, NetBIOS 



Defining STS Targets 

Target name and address information is specified by way of various parameters. This 
section is a brief summary of this information in relation to target definition for STS 
communication. For each target you define: 

• Domain address and target address 

You provide this information when you define a target using the graphical interface 
or the addtg line command. The combination of the two 

(<domain address>.<target address>) uniquely identifies the target in a network. 

• Protocol type 



Additional target identification information is needed for STS connections. A 
target's protocol type can be TCP/IP, APPC, IPX, or NetBIOS. Include one of the 
following in the addtg command, depending on the protocol: 

-tp TCP:<hostname> 

-tp APPC:<rgn.ren.LU> 

-tp IPX:<ip_address> 

-tp NBI : <NetBI0S address> 
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Chapter 15. Configuring SNA/DS Remote Connection Files 



This chapter describes how to configure configuration files for an SNA/DS network that 
uses APPC connections. You need to edit this configuration information to define or 
update SNA/DS connections to remote nodes. 



Editing Connection Configuration Files 

The configuration information for SNA/DS connections is held in three different text 
files, which can be edited using a text editor. 

The files are owned by root and can be accessed by the administrator, the same user 
who can make configuration changes to TME 10 Software Distribution, Version 3.1.5 
for OS/2 using the graphical interface. 

The files that can be edited are: 

SNA/DS configuration file 

This file contains the system parameters for controlling TME 10 Software 
Distribution, Version 3.1.5 for OS/2's use of the SNA/DS network 
implemented across APPC connections. 

SNA/DS connection configuration files 

This file contains the details of an APPC connection to an adjacent node. 

Routing table 

This file instructs the distribution server which APPC connection should be 
used use when distributions are sent to remote targets. 

If you edit one of these files while TME 10 Software Distribution, Version 3.1.5 for 
OS/2 is running, you must use the rid command to reload configuration changes. 



SNA/DS Configuration File 

The SNA/DS configuration file, <prod_di r>\db\snadscfg where <prod_dir> is the 
directory where the product was installed, contains system parameters for controlling 
the use that TME 10 Software Distribution, Version 3.1.5 for OS/2 makes of the 
SNA/DS network. You only need to edit the SNA/DS configuration file when performing 
system tuning, and access is usually restricted to the administrator. 



The file is st ored with a fixed text for mat. Each line starts with one of the keywords 
described in Table 24 on page 134 Enter each keyword in uppercase and end it with 
a colon (:). 



Each keyword can be used only once. The order of the keywords is not important, and 
blank and comment lines can be included. Comment lines begin with a number 
sign (#). 



© Copyright IBM Corp. 1993, 2000 
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Table 24. SNA/DS Configuration File Parameters 



Keyword 


Description 


ORIGIN HOP COUNT 


The default hop count to be used for distributions originated 
by TME 10 Software Distribution, Version 3.1.5 for OS/2 
when the hop count is omitted or is specified as zero in the 
routing table. (See|“Editinq the SNA/DS Routinq Table” on| 
Ipaqe 1371) An appropriate value for this field is 5. 


MAX CRMU 


The maximum number of Completion Report Message Units 
(CRMU) that TME 10 Software Distribution, Version 3.1.5 for 
OS/2 sends at one time when it detects that Message Unit ID 
(MUJD) registries are out of synchronization. 

You do not normally need to change the value of this field. It 
is used for performance tuning. If the value is low then 
resynchronization of registries take longer. If the value is 
high, then system resources are consumed by the 
resynchronization and are not available for normal 
processing. 

Because resynchronization should be rare, and it is unlikely 
that a connection would have many MUJDs outstanding at 
any time, 5 is a reasonable value. 


TRANSMISSION HOLD 
TIME 


The time for which a connection should be held by 
TME 10 Software Distribution, Version 3.1.5 for OS/2 after a 
severe transitory error or an error requiring operator 
intervention has been detected. 

Enter a value in seconds. An appropriate value is 1000 
seconds (16 minutes). 


ALLOCATION FAILURE 
RETRY TIME 


The number of seconds that TME 10 Software Distribution, 
Version 3.1.5 for OS/2 is to wait before attempting to 
reestablish a conversation on this connection after a previous 
conversation has been unsuccessful. This prevents thrashing 
when a connection is unavailable. 

Enter a decimal number. A reasonable value is 300 seconds 
(five minutes). 



The following is an example of the SNA/DS Configuration File. 
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SNA/DS Connection Configuration File 



# SNA/DS CONFIGURATION FILE 

# 




# This file should be stored as 


\<prod di r>\db\snadscfg 


ORIGIN HOP COUNT: 


10 


MAX CRMU: 


5 


TRANSMISSION HOLD TIME: 


3600 


ALLOCATION FAILURE RETRY TIME: 


1000 



Figure 43. Example of an SNA/DS Configuration File 



SNA/DS Connection Configuration Files 

SNA/DS connection configuration files define the details of the APPC connection to 
adjacent nodes. Each file is given the name of the connection it defines. Up to 800 
connection configuration files can be defined, while up to 100 connections can be active 
simultaneously. 

The files are stored in the directory <prod_di r>\db\snadscon, where <prod_dir> is the 
directory where the product was installed. 

Access is usually restricted to the administrator. Sample connection configuration files 
are provided in the same directory. 

Each file is stored with a fixed text format. Each line starts with one of the keywords 
described in Table 25. Enter each keyword in uppercase and end it with a colon (:). 

Each keyword can be used only once. The order of the keywords is not important, and 
blank and comment lines can be included. Comment lines begin with a number sign 
(#). 



Table 25 (Page 1 of 2). SNA/DS Connection Configuration File Parameters 


Keyword 


Description 


FULLY QUALIFIED 
PARTNER LU NAME 


The LU name of the node on the other end of this 
connection. 


LOCAL LU ALIAS NAME 


The logical unit alias of the local machine, as specified in the 
Personal Communications configuration. 


REMOTE SERVER NAME 


Remote server workstation name 


MODE NAME 


LU62 
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Table 25 (Page 2 of 2). SNA/DS Connection Configuration File Parameters 



Keyword 


Description 


NEXT DSU 


The domain address and target address of the SNA/DS node 
at the other end of this connection. You must find out this 
information from the system administrator at the other node. 

The RGN and REN must be entered as consecutive strings 
separated by a period. 


PROTOCOL 


APPC The APPC protocol is used. 


RETRY LIMIT 


The number of times that TME 10 Software Distribution, 
Version 3.1.5 for OS/2 is to retry the transmission of a 
distribution (file or change management command) before 
reporting an error. 

Enter a decimal number. A reasonable value is 3. 


RECEIVE MUJD 
TIME-OUT 


The number of seconds that TME 10 Software Distribution, 
Version 3.1.5 for OS/2 is to wait before retrying the receipt of 
a distribution. This value prevents thrashing if a transitory 
error has been detected. 

Enter a decimal number. A reasonable value is 120. 


SEND MUJD TIME-OUT 


The number of seconds that TME 10 Software Distribution, 
Version 3.1.5 for OS/2 is to wait before retrying the 
transmission of a distribution. This value prevents thrashing 
if the remote node has detected a transitory error. 

Enter a decimal number. A reasonable value is 60. 


TRANSMISSION 

TIME-OUT 


The number of seconds that TME 10 Software Distribution, 
Version 3.1.5 for OS/2 is to wait before retrying the 
transmission of an MUJD that failed or was interrupted. This 
prevents thrashing when a transitory error occurs. 

Enter a decimal number. A reasonable value is 60. 


TYPE 


SNA For an SNA/DS connection type. 



Fig ure 44 on page 137 I s an example of an SNA/DS connection configuration file for 
APPC. This sample file, called DEFCONFA, is installed during product installation, under 
the <prod_dir> directory. 
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# SNA/DS CONNECTION CONFIGURATION FILE FOR CONNECTION DEFCONFA 

# 

# This connection is used to handle transmissions between 


# TME 10 Software Distribution, 


Version 3.1.5 for OS/2 servers. 


f 

# This file should be stored as 


<prod di r>\db\snadscon\defconfa 


PROTOCOL: 


APPC 


TYPE: 


SNA 


FULLY QUALIFIED PARTNER LU NAME: 


: ITI BMOPC . D3C73D01 


LOCAL LU ALIAS NAME: 


LT0142AO 


REMOTE SERVER NAME: 


D3C73D01 


MODE NAME: 


LU62 


NEXT DSU : 


ITI BMOPC . D3C73D01 


TRANSMISSION TIME-OUT: 


60 


RETRY LIMIT: 


3 


SEND MU ID TIME-OUT: 


60 


RECEIVE MU ID TIME-OUT: 


120 



Figure 44. Example of an SNA/DS Connection Configuration File for APPC 



Editing the SNA/DS Routing Table 

This section describes how to define the connections in the SNA/DS routing table. 

The routing table is an editable text file that tells the distribution server which APPC 
connection to use when sending a distribution to a remote target. Set up this table to 
reference the connections that you have configured for your system. A routing table 
can contain up to 1600 entries. 

You do not need to configure a routing table if you do not enable remote 
communication. You only need to edit it when you add a new remote connection, or 
when you want to tune a complex network by careful matching of routes and 
connections. 

A sample routing table is set up for you when you enable remote communication. The 
file is <prod_dir>\db\routetab, where <prod_dir> is the directory where the product 
was installed. You need to change this table to define routes in it. 

The routing table contains the definition of the network ID for the distribution server and 
for each of the distribution clients in a network. It also defines a number of routes. 

Each route has the following data associated with it: 

• Protocol type: APPC 

• SNA/DS address of the targets reached by this route 

• The name of the connection to use 

• The SNA/DS hop count to use on distributions sent to this route. 
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The following parameters can also be included in a routing table for APPC routes: 

• Service parameter thresholds specifying: 

- The minimum distribution priority allowed on the route 

- The maximum size distribution allowed on this route 

- The SNA/DS security provided by this route 

- The SNA/DS protection provided by this route. 

Planning a Simple Routing Table 

In a simple configuration, your distribution server is attached to just one remote node. 
Only one connection is defined and this takes all distributions to and from the 
distribution server. 

You need only configure a single route. The SNA/DS address should be given as *.* 
to allow any SNA/DS name to be routed. If included, set the connection service 
parameters to show that any value is supported on the connection. 

Planning a Complex Routing Table 

Plan a complex routing table with care. Remember that a distribution is sent on the 
first route in the table that meets the requirements of the distribution. You should, 
therefore, put specific SNA/DS addresses before generic ones, and restricted 
connections before all-purpose ones. 

You may find it helpful to draw a diagram of your connections to adjacent NetView DM 
nodes before you start. In your diagram, you can put the SNA/DS addresses of the 
remote targets reached through each node, and the services offered by each 
connection. 

The diagram helps you ensure that distributions are routed to the correct destinations, 
and that no distribution is unexpectedly rejected because there is no connection 
capable of carrying it. 

If you have a busy system, you can reserve some connections for handling small, 
high-priority distributions. This prevents them from being held up until active, large 
distributions complete. You can do this by setting the priority and capacity service 
parameters on the reserved connections. 

Determining Destination Addresses 

Routes in your routing table must identify the destination target of the link being 
defined. A target is identified by two values: 

• Its domain address (usually the same as its server name) 

• Its target address 

These two values are separated by a period (.) and are expressed in this format in 
routes in the routing table: 

<domain address>.<target address> 

The domain address is the same as a target's server name. 
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In SNA terminology, these values correspond to: 
<routing group name>.<routing element name> 

which is commonly expressed as: 

<RGN>.<REN> 



The two values are referred to using different terms on the various platforms that can 
be included in a TME 10 Software Distribution, Version 3.1.5 for OS/2 network. To 
identify a target's <domain address> and <target address> look for these 
corresponding terms: 



Table 26. Target Identification Terms 


Type of Target 


Domain address 


Target address 


NetView DM for MVS 


Network ID * 


LU name * 


TME 10 Software Distribution Server 


domain address 


target address 



Note: * In a NetView DM for MVS-controlled network, the network ID is the same as the 
network ID defined for the NetView DM for MVS system it is part of. The LU name uniquely 
identifies the node within that network. You can find out what this is by contacting the 
administrator at that site. You set the local network ID just once. This value is picked up for 
the RGN of all local nodes. 



Defining Routes 

Before defining the routes in a routing table, the type of network you are defining must 
be specified. For the NETWORK PROTOCOL keyword, at the beginning of the routing 
table, specify APPC. 

Each route is defined by exactly one line in the routing table. Lines in a routing table 
can be any length. Blank lines are permitted between routes in the routing table. 
Comment lines begin with a number sign (#). 

Enter information in the order shown in |Table 27 on page 140 t o define a route. 
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Table 27 (Page 1 of 3). Defining a Route in the SNA/DS Routing Table 

Parameter Description 

Destination Address The destination SNA/DS nodes that this route serves, as an 

SNA RGN.REN address. TME 10 Software Distribution, 
Version 3.1.5 for OS/2 searches the table for an entry 
matching the destination of each distribution that it sends. If 
no match is found, a distribution report is generated and 
returned to the originator of the distribution. 

Enter the address in the form: 

<domain address>.<target address> 

Each value can be up to eight characters long. The 
characters must be either uppercase letters, numbers, or the 
special characters @, #, and $. For example NETWK1.LU0001. 

You can use the asterisk (*) and question mark (?) as 
wildcard characters. 

See [“Determining Destination A ddresses” on page 138| for 
additional information. 



Minimum Distribution 
Priority 



The minimum distribution priority that this route supports. 

This parameter is optional, and can only be used for APPC 
routes. 

When TME 10 Software Distribution, Version 3.1.5 for OS/2 
has matched an SNA/DS address, it checks the priority 
available. If the distribution does not have high enough 
priority to use this route, TME 10 Software Distribution, 
Version 3.1.5 for OS/2 continues to search for another one. 

The priority values are: 

FAST 

Allows only distributions with priority FAST on this route. 

CONTROL 

Allows only distributions with priority FAST or 
CONTROL on this route. 

DATA16 

Allows only distributions with priority FAST, CONTROL, 
or DATA16 on this route. 

DATA15 

Allows any distribution with priority DATA15 or higher 
on this route. 

DATA14 ... DATA1 

Allow any distribution with priority DATAn or higher on 
this route, where n is any number in the range 1 
through 14. 

ANY 

Allows any priority distribution on this route. 
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Table 27 (Page 2 of 3). Defining a Route in the SNA/DS Routing Table 

Parameter Description 

Distribution Protection The distribution protection that this route provides. The 

protection parameter specifies whether the distribution must 
be stored on nonvolatile storage while a DSU has 
responsibility for it. If a distribution requires more protection 
than a route can provide, the route is not used. This 
parameter is optional, and can only be used for APPC routes. 

The protection values are: 

LEVEL2 

Level-2 protection is provided on this route, which 
indicates that the distribution is safe-stored in 
nonvolatile storage. 

ANY 

Any requested level of protection is supported on this 
route. 

Maximum Size The maximum size distribution that this route supports. This 

Distribution is the capacity of the route. If a distribution is larger than this 

size, the route is not used. This parameter is optional, and 
can only be used for APPC routes. 

The capacity values are: 

ODATA 

No distribution carrying data is allowed on this 
connection. Only reports are sent. 

1 MEGABYTE 

Only distributions with less than 1 MB of data are sent 
on this connection. 

4MEGABYTES 

Only distributions with less than 4 MB of data are sent 
on this connection. 

16MEGABYTES 

All distributions can use this connection. 

ANY 

All distributions can use this connection regardless of 
the amount of data being carried. 
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Table 27 (Page 3 of 3). Defining a Route in the SNA/DS Routing Table 


Parameter 


Description 


Distribution Security 


The distribution security that this route provides. The security 
parameter specifies that the distribution is to be safeguarded 
from unauthorized access while it is being sent through the 
DS network. If a distribution requests higher security than a 
route can provide, the route is not used. This parameter is 
optional, and can only be used for APPC routes. 

The security values are: 

LEVEL2 

Level-2 security is provided on this route, which 
indicates that DS should route the distribution on 
sessions that are designated secure. 

ANY 

Any requested level of security is supported on this 
route. 


Connection Name 


The connection name for this route. This name relates to the 
SNA/DS connection file that you create under 
<prod_dir>\db\snadscon, where <prod_dir> is the directory 
where the product was installed. For consistency this name 
can be the host name of the system you are connecting to. 


Hop Count 


This parameter defines the hop count for all distributions sent 
out using this route. It indicates the maximum number of 
SNA/DS nodes that the distribution can legitimately pass 
through before reaching its destination. The hop count 
prevents distributions from looping between SNA/DS nodes in 
the network with contradictory routing tables. 

Enter the hop count as a decimal digit. Set the value to one 
if the next node on this route is an end node. If you are 
unsure of the topology of your network, set the field to 5. 

Hop count can be omitted from a routing table. If it is not 
defined, the value defaults to the one defined for Origin Hop 
Count in the SNA/DS configuration file (see|“SNA/DS| 
IConfiquration File” on page 1331. 



Sample routing tables follow. They are supplied with TME 10 Software Distribution, 
Version 3.1.5 for OS/2 in the <prod_dir>\db\routetab file, where <prod_dir> is the 
directory where the product was installed f Figure 45 on page 1431 is an example of an 
SNA/DS routing table for APPC routes. 
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# SNA/DS ROUTING TABLE 

# This table provides SNA/DS routing information for a 

# TME 10 Software Distribution, Version 3.1.5 for OS/2 SNA network. 

# This file should be stored as <prod_di r>\db\routetab 

NETWORK PROTOCOL: APPC 

# 



# Destination 

# Address 

# 


Priority 


Protection 


Capaci ty 


Securi ty 


Connecti on 


Hop 


SRVSNA1 .* 


DATA 16 


ANY 


1MEGABYTE 


ANY 


C0NNSNA1 




SRVSNA2.* 


ANY 


ANY 


ANY 


ANY 


C0NNSNA2 




* . * 


ANY 


ANY 


ANY 


ANY 


C0NNSNA3 





Figure 45. Example of an SNA/DS Routing Table for APPC routes 



An example of an SNA/DS routing table for APPC and TCP/IP connection protocols is 
shown in Figure 46. 



# SNA/DS ROUTING TABLE 

# This table provides SNA/DS routing information for 

# a TME 10 Software Distribution for OS/2 combination TCP/IP and APPC network. 

# This file should be stored as \<prod_di r>\db\routetab 

NETWORK PROTOCOL: BOTH 

# 

# SNA/DS Priority Protection Capacity Security Connection Hop 

# Destination 

# address 

# 



ITIBM0PC.CTNDM15G 


ANY 


ANY 


ANY 


ANY 


CTNDM15G 


5 


SNA001.SNA001 


ANY 


ANY 


ANY 


ANY 


POWER 


5 


SERVER01.SERVER01 

SERVER02.SERVER02 


ANY 


ANY 


ANY 


ANY 


SERVER01 

SERVER02 





Figure 46. Example of an SNA/DS Routing Table for both APPC and TCP/IP protocols 
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Part 3. TME 10 Software Distribution Scenarios 



This part presents scenarios that guide you through typical tasks using the 
TME 10 Software Distribution functions. The scenarios show how to: 



Prepare software using generic preparation ([“Scenario 1 : Preparing a 



Non-CID-Enabled Application in Basic Mode” on page 152 and “Scenario 3:| 



Preparing a Non-C I D-Enabled Application in Advanced Mode” on page 166j 
Prepare software using DiskCamera |“Scenario 4: Replicating an Installation with 



DiskCamera” on page 181 1 and [“Scenario 5: Installing an Application from the 



Internet using DiskCamera” on p age 1 94^ ~ 

Do a push installation of a software object to clients {“Scenario 2: Installing a] 
ISoftware Object to a Target (Push Installation)” on page 167t 

Authorize a client to do pull installations ([“Scenario 6: Defining and A uthorizing a 



Client to Install Software Objects” on page 205) 

Do a pull installation of a software object from a client d“Scenario 7: Installing an| 
Application at a Client (Pull Installation)” on page 21 1 ^ 



• Set up the environment required for CID software preparation jChapter 17, “Setting] 
lUp for CID Preparation” on page 2151 . 



© Copyright IBM Corp. 1993, 2000 
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Chapter 16. Software Distribution Scenarios 



The following scenarios show the preparation, distribution, and installation of 
applications. 



The Software Distribution Environment 

Before running the scenarios, be sure that you have, for example, the environment 
shown in Figure 47. 



Distribution Server 
HFSERVER 




Distribution Target Preparation Site 

HFCLIENT MYPREP 



Figure 47. Software distribution environment 

Be sure also that you have completed the following activities: 

1 Installing the distribution server 

The TME 10 Software Distribution server must be installed and configured on the 
LAN administrator workstation. The system name used during configuration is, for 
these scenarios, HFSERVER. See lChapter 9, “Installing an OS/2 Distribution! 
Server” on page 53~[ for a detailed explanation of installing and configuring a 
TME 10 Software Distribution server. 

2 Installing the distribution client 

The TME 10 Software Distribution client must be installed and configured on the 
target workstations. For these scenarios, the system names used during 
configuration are HFCLIENT and MYPREP. Both HFCLIENT and MYPREP use 
HFSERVER as their distribution server. 



© Copyright IBM Corp. 1993, 2000 
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3 Starting the distribution server 

The server is automatically started at system startup. If for any reason a 
distribution server (in this example, HFSERVER) has been stopped, restart it by 
performing the following steps: 

a From the TME 10 Software Distribution for OS/2 Server window, open the 
TME 10 Software Distri bution for OS/2 Catalog window, as shown in 
Figure 48 on page 148 



B1 Software Distribution for OS2 Catalog (root at HFSERVER) 



Catalog Selected View System Distribution Engine Windows Help 

Global File Name Description 



□ □ 



IBM.FM2.REF. 100.1 


File Manager/2 


1 BM. M Y. SAMPLE. DYHAM 1 C. REF. 1 0 0 . 1 


MY.Sample.Dynamic 


IBM.MY.SAMPLE.REF. 100.1 


MY. Sample 


IBM.MY.SAMPLE.REMOTE.REF. 100.1 


My.Sample. Remote 


IBM.SV4 W.SERVER.REF. 1 .0.US 


SystemView Server 


IBM.XLATOR.REF. 100.1 


XLATOR 


L 

L 


L 

L 



Figure 48. TME 10 Software Distribution for OS/2 Catalog window 

b Select Engine from the menu bar. 

C Select Start the system from the pull-down menu. 

The TME 10 Software Distribution Agent window is displayed, as shown in 
Figure 49. 




Figure 49. TME 10 Software Distribution Agent window 
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Software Distribution Environment 



Wait for the message: 

D&CC Agent and server HFSERVER have been (re)connected. 

The Catalog informational message is displayed, as shown in Figure 50. 




Figure 50. Catalog informational message 

d Click on the OK push button. The restarting of the distribution server is 
completed. 

4 Defining the distribution clients 

To define a group of clients as the target for distribution, refer to|“Scenario 6:1 
Defining and Authorizing a Client to Install Software Objects” on page 205 

5 Starting the distribution clients 

When a distribution server starts, all of its distribution clients that are started are 
automatically connected to the server. To view the list of the distribution clients, 
enter the following command from an OS/2 window: 

nvdm Istg * 

If for any reason a distribution client (in this example, HFCLIENT) has been 
stopped, restart it by performing the following steps: 

a From the TME 10 Software Distribution Client for OS/2 window, open the 
TM E 10 Software Distri bution for OS/2 Catalog window, as shown in 
Figure 51 on page 150 
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*1 1 HI li'ld II 1 1 I I i'l I " □ 

Catalog Selected View System Distribution Engine Windows Help 



Global File Name 



Description 



IBM.FM2.REF. 100.1 


File Manager/2 


J 


1 BM. M Y. SAMPLE. D YNAM IC.REF.100.1 


MY.Sample.Dynamic 




IBM.MY.SAMPLE.REF.100.1 


MY. Sample 




IBM.MY.SAMPLE.REMOTE.REF. 100.1 


My.Sample. Remote 




IBM.XLATOR.REF. 100.1 


XLATOR 








J 



Figure 51. TME 10 Software Distribution for OS/2 Catalog window 



b Select Engine from the menu bar. 

C Select Start the system from the pull-down menu. 

The TME 10 Software Distribution Agent window is displayed, as shown in 
Figure 52. 




Figure 52. TME 10 Software Distribution Agent window 
Wait for the message: 

D&CC Agent and server HFSERVER have been (re)connected. 

The Catalo g informational message is displayed, as shown in iFiqure 53 on| 
page 151 
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Figure 53. Catalog informational message 



d Click on the OK push button. The restarting of the distribution client is 
completed. 

Setting Up the Code Server 

If you plan to distribute CID-enabled software, set up the code server as 



explained in “Completing the Setup on the Code Server Workstation” on 
Ipage 224| 



Distribution Database Recovery Tool 

This tool is part of t he distribution server. T he corresponding icon is in the product 

It provides a recovery procedure that you 



folder, as shown in jFigure 67 on page 161 



can run on the distribution server catalog when a specific error occurs. 



If, following an error condition, you find this message in the distribution server message 
log: 

Open file for <file_name> record returned - 40 

after making sure all software distribution functions are stopped, click on the 
TME 10 Software Distribution Database Recovery Tool icon. 



Depending on the error condition, the recovery tool either rolls back the catalog to its 
pre-error state, or updates it correctly. 

After the recovery procedure has run successfully, you can restart the distribution 
server. 



TME 10 Software Distribution Database Cleanup Tool 

This tool is part of t he distribution server. T he corresponding icon is in the product 

It reclaims unused space resulting from 



folder, as shown in Figure 67 on page 161 



deletion of entries from the database. 



Before starting this tool, stop the distribution server. 

To prevent database corruption, the tool makes a copy of the original database. The 
copied database tables are renamed with the extension bak and are stored under the 
database product directory. Therefore you must ensure that enough disk space is 
available for the backup copy. You can, optionally, manually save the *.bak tables in 
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your own backup repository. To delete the *.bak copy from the TME 10 Software 
Distribution product directory, type the fnddbdel command from an OS/2 window or full 
screen. Every backup copy of *.bak files overlays any existing ones. 



Scenario 1: Preparing a Non-CID-Enabled Application in Basic Mode 

During this scenario, you create a software object and copy it into the catalog at the 
distribution server. 

Before beginning software preparation, perform these steps: 

1 Make the sample directory on the F drive of the preparation site workstation 

2 Create samplel.dat and sample2.dat files under the sample directory 

To create a software object for a non-CID-enabled application, such as the above 
sample product, perform the following steps at the preparation site: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 
shown in Figure 54. 



TME 10 Software Distribution for OS/2 - Icon View 




Software Distribution Server 
Documentation 




Tivoli SD (3.1.5) 
SW Preparation 




Tivoli Software Distribution 

m 




Tivoli SD (3.1.5) 
Message Log 




Tivoli Distribution Server 
Installation Utility 



Tivoli APPC Configuration SmartGuides 



Tivoli Distribution Server 
Configuration 



Tivoli Distribution DataBase Tivoli Distribution DataBase 
Cleanup T ool R ecovery T ool 



Stop Software Distribution 
Server 



Start Software Distribution 
Server 



Figure 54. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the Software Preparation icon. 

The Softw are Preparation folder is displayed, as shown in jFi gure 55 on| 
Ipaqe 153| 
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Software Preparation 



Selected View Help 



|° □ 



1 




1 


| Generic Software 



rSV 

i mu i 

CID Software 



Double click to create a generic software object profile 



Figure 55. Software preparation folder 

3 Double-click on the Generic Software icon. 

The Software Object Profiles window is displayed, as shown in Figure 56. 




Figure 56. Software object profiles window 



4 Select Software from the menu bar. 

5 Select Create new... from the New choice in the pull-down menu. 

The New S oftware Profile window is displayed, as shown in Fi gure 57 on| 
page 154 
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Figure 57. New software profile window 

6 For Name, enter MY. Sample. 

7 Select the Basic radio button in the Configure As group to a basic creation of a 
software profile. 

8 Click on the Configure... push button. 

The MY. Sample - Basic Configuration notebook is displayed, as shown in 
Figure 58 on page 1551 
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Figure 58. MY. Sample - basic configuration: general page 

9 Leave the defaults in the General page. 

10 Select the Files tab. The Files page is displayed. 
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Figure 59. MY. Sample - basic configuration: files page 

11 In the Files page, choose the files to be included in the software object. Click on 
the Find push button and the Open window is displayed, as shown in Figure 60. 




Figure 60. Open window 

12 Choose the files that will be included in the software object and click on the Add 
push button. 
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The selected files are included in the Files in software object container on the 
Files page, as shown in | Figure 61 on page 157| 







Preparing a Non-CID Application (Basic) 




Figure 61. MY. Sample - basic configuration: files page 

13 You may need to change the destination of the files that will be installed from F to 
C. To make this change, select the sample1.dat file in the Files in software 
object container and choose the Options push button. The File Options window 
is displayed, as shown in [Figure 62 on page 158j 
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Figure 62. File options window 



14 Change the destination of sample1.dat from F to C, by changing the installation 
path in the Destination entry field. 



15 

16 
17 



Click on the OK push button. 

Repeat the steps 12, 13 and 14 for sample2.dat file. 

Close the notebook. The New Software Profile window is displayed again, as 



shown in |Figure 63 on page 159 
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Figure 63. New software profile window 

18 Leave the check box checked and click on the OK push button to build the 
software object and put it into the catalog. 

19 A progress indicator is displayed, as shown in Figure 64. 



Software Object Profiles 



Cataloging software object 



0% 25% 50% 75% 100% 



Figure 64. Software object profiles progress indicator 

20 A Software Object Profiles informational message is displayed, as shown in 
[Figure 65 on page 160| 
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Software Object Profiles 

O FNDSG028I: Software object 

IBM.SWPREP.052796.1620.REF.100. 
1 was built and cataloged 
successfully. 



OK 






Help 



Figure 65. Software object profiles informational message 

21 Click on the OK push button. The Software Object Profiles window is displayed. 
It contains the MY. Sample software object profile just created, as shown in 
Figure 66. 



Software Object Profiles 



Software Catalog window Selected Edit View Help 

Ip 

MY.Sample 



Select New to create a new software object profile 



Figure 66. Software objects profile window 

Now the MY.Sample software object is ready to be installed. 
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Scenario 2: Installing a Software Object to a Target (Push Installation) 

In this scenario, you install a software object from the distribution server catalog to a 
client workstation. 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 
shown in Figure 67. 



TME 10 Software Distribution for OS/2 - 


Icon View 


_uj □ 


1 m 


OinO 

QZ) IZZ) 


HD 




Software Distribution Server 


Tivoli Software Distribution 


Tivoli SD (3.1.5) 




Documentation 


m 


Message Log 

i 




Tivoli SD (3.1.5) Tivoli APPC Configuration SmartGuides Tivoli Distribution Server 




SW Preparation 




Installation Utility 






cf 


f 




Tivoli Distribution Server 


Tivoli Distribution DataBase 


Tivoli Distribution DataBase 




Configuration 


Cleanup T ool 


Recovery Tool 




Fi 


ingi 






Stop Software Distribution 


Start Software Distribution 






Server 


Server 







Figure 67. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the TME 10 Software Distribution icon. 

The TME 10 Software Distribution for OS/2 Logon window is displayed, as shown 
in [Figure 68 on page 162| 
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Software Distribution for OS/2 Logon 



The password will not be displayed 



User ID 



Password 



Server name HFSERVER 



Servers 



HFSERVER 



Logon 



Cancel 



Figure 68. TME 10 Software Distribution for OS/2 logon window 



3 Enter your user ID and password, and click on the Logon push button. 

The TME 10 Software Distribution for OS/2 Catalog window is displayed, as 
shown in Figure 69. 



HI Software Distribution for OS2 Catalog (root at HFSERVER) 


□ 


Catalog Selected View System Distribution Engine Windows Help 


Global File Name 


Description 


| lBM.MY.SAMPLE.REF. 100.1 i 


[ MY.Sample 


J 












■ 

1 



Figure 69. TME 10 Software Distribution for OS/2 Catalog window 
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Then perform the following steps: 

4 Select MY.Sample software object. 

5 Select Install... from the Selected menu choice. The Install Change Files 
5 window is displayed, as shown in Figure 70. 




Figure 70. Install Change Files window 

6 Select the target in the Targets list. 

7 To schedule the installation, click on the Scheduling... push button. The 
Scheduling Information window is displayed, as shown in Fi gure 71 on page 164| 



5 The terms change file and software object are synonyms. 
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Figure 71. Scheduling information window 



8 Click on the first Schedule... push button. The Schedule Time window is 
displayed, as shown in Figure 72. 




O Immediately 
(• Deferred 



2| Tinu 



11 



M 56 l f^i 



21 Date 18 [Sj 



June 



2000 



OK 



Cancel 



Help 



Figure 72. Schedule time window 



9 Enter the new time and date and click on the OK push button. The Scheduling 



Information window is displayed again, as shown in Figure 73 on page 165 
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Figure 73. Scheduling information window 

10 Click on the OK push button. The Install Change Files window is displayed, as 
shown in iFigure 70 on page 1631 

1 1 Click on the Install push button. The Correlators window is displayed, as shown 
in Figure 74. 




Figure 74. Correlators window 

12 Click on the OK push button. The Install Change Files window is displayed again. 

13 Click on the Close push button. The Catalog window is displayed. The installation 
of the software object is completed. 
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To verify the results of installation, see [“Verifying the Results of Installation” on| 

Ipaqe 1 66j 

Verifying the Results of Installation 

You can see the messages from the installation: 

• In a file that you can access by entering the command NVDM LOG from an OS/2 
window. 

• In the TME 10 Software Distribution Agent window. 

For additional installation messages, perform the following steps to look at the file 
FNDLOG under <installation_drive>:\SOFTDIST: 

1 Open an OS/2 window. 

2 Enter the commands: 

Type <i nstal 1 at i on_dri ve>: \S0FTDI ST\ FNDLOG 
>C:\install .msg 

3 Look at the file install. msg in drive C. 

If the FNDLOG file contains the message: 

FNDSH220E: The scheduler failed to start a task to process a request 

then you may need to increase the number of threads in the THREADS=xxx in 
CONFIG.SYS. 



Scenario 3: Preparing a Non-CID-Enabled Application in Advanced Mode 

During this scenario you will perform these tasks: 

• Use the Remote Directory function to create a software object and copy it into the 
catalog at the distribution server. 

• Create a dynamic software object and copy it into the catalog at the distribution 
server. 

Creating a Software Object Profile Using the Remote Directory Function 

In this scenario, you create a software object to distribute a sample product, as follows: 

• Make the sample remote directory on the F drive of a workstation different from the 
preparation site 

• Create the samplel.dat and sample2.dat files under the sample remote directory 

To create and catalog the software object, perform the following steps at the 
preparation site: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 
shown in |Figure 75 on page 167| 
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TME 10 Software Distribution for OS/2 


- Icon View 


IeJ d 


m 


fi'fi 


HD 




Software Distribution Server 
Documentation 
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Message Log 
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Tivoli SD (3.1.5) Tivoli APPC Configuration SmartGuides Tivoli Distribution Server 
SW Preparation Installation Utility 




diy, 
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Figure 75. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the Software Preparation icon. 

The Software Preparation folder is displayed, as shown in Figure 76. 



Software Preparation 



Selected View Help 



■ 


% 


I 


| Generic Software | 



ritV 

r-imi i 

CID Software 



Double click to create a generic software object profile 



Figure 76. Software preparation folder 



3 Double-click on the Generic Software icon. 

The Softw are Object Profiles window is displayed, as shown in Fig ure 77 on| 
Ipaqe 168| 
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Figure 77. Software Object profiles window 

4 Select Software from the menu bar. 

5 Select Create new... from the New choice in the pull-down menu. 

The New Software Profile window is displayed, as shown in Figure 78. 




Figure 78. New software profile window 

6 For Name, enter MY.Sample.Remote. 

7 Select the Advanced radio button in the Configure As group to do an advanced 
creation of a software profile. 

8 Click on the Configure... push button. 

The My. Sample. Remote - Advanced Configuration notebook is displayed, as 
shown in |Figure 79 on page 169| 
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Figure 79. My. Sample. Remote - advanced configuration: general page 

9 Leave the defaults in the General page. 

10 Select the Remote Directory tab. The Remote Directory page is displayed, as 
shown in [Figure 80 on page 170| 
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■Sy MY.Sample.Remote - Advanced Configuration 



± 

=p 

i 

=p 

i 



Information to mount a remote directory 
Server name 



Exported directory 



HFSERVER 



Export parameters 



Sample 




Mount drive Mount parameters 


F: 





Exported directories list 
Server name Exported directory Mount parame 



HFSERVER Sample 



IZL 




Add 



Change 



J 



Delete 



General 



Files 



Conditions 



Scripts 



Variables 



Remote Direct 



SW Prereq. 



Remote Directories - Page 1 of 1 +■ ■+ 



HW Prereq. 



Command 



Options 



Compression 



Figure 80. My. Sample. Remote - advanced configuration: remote directory page 



In the Remote Directory page, choose the remote directory containing the files to 
be included in the software object. These files will be downloaded using a mount 
process at installation time. 



1 1 Fill in the entry fields contained in the Information to mount a remote directory 
group, as shown in Figure 80. 

Server name The name of the distribution server. 



Exported directory 
Export parameters 
Mount drive 
Mount parameters 



The remote directory that will be mounted. It contains the 
files for the software object. 

The parameters that define the mode in which the 
directory is to be exported. This parameter is optional. 

The name of the drive from which the destination target 
is to mount the remote directory. 

The parameters that define the mode in which the drive 
is to be accessed. 



12 Click on the Add push button. 

The mount information is included in the Exported directories list container. 

13 Close the notebook. The New Software Profile window is displayed again, as 
shown in jFigure 81 on page 171 1 
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Figure 81. New software profile window 

14 Leave the check box checked and click on the OK push button to build the 
software object and put it into the catalog. 

15 A progress indicator is displayed, as shown in Figure 82. 



Software Object Profiles 



Cataloging software object 



0% 25% 50% 75% 100% 

J I I I L 



Figure 82. Software object profiles progress indicator 



16 A Software Object Profil es informational message is displayed, as shown in 
Figure 83 on page 172 



Chapter 16. Software Distribution Scenarios 171 





Preparing a Non-CID Application (Advanced) 



Software Object Profiles 

O FNDSG028I: Software object 

IBM.SWPREP.852796.1620.REF.108. 
1 was built and cataloged 
successfully. 



OK 






Help 



Figure 83. Software object profiles informational message 



17 Click on the OK push button, the Software Object Profiles window is displayed. It 
contains the My.Sample.Remote object just created, as shown in Figure 84. 



Software Object Profiles 



Software Catalog window Selected Edit View Help 



Wf 

MY.Sample.Remote 



Select Hew to create a new software object profile 



Figure 84. Software objects profile window 

Now this software object is ready to be installed. For the installation procedure see 
PScenario 2: Installing a Software Object to a Target (Push Installation)” on page 161 1 

Creating a Dynamic Software Object 

A dynamic software object allows you to install different objects (files) on different 
workstations (targets) during the same installation. Each file is linked to a specific 
dynamic section containing the installation condition. 

In this scenario, you create a dynamic software object that allows dynamic installation. 
File sample1.dat is installed on a target that has a 150-MB hard disk, and sample2.dat 
is installed on a target that has a 200-MB hard disk, with the same install operation. 

This example uses the sample product MY. Sample created at the beginning of 
“Scenario 1: Preparing a Non-CID-Enabled Application in Basic M ode” on page 152 

1 Create the MY.Sample.Dynamic software profile in advanced mode, as shown in 
“Creating a Software Object Profile Using the Remote Directory Function” on| 
page 166 

2 Open the My. Sample. D ynamic - Advanced Configuration notebook, as shown in 
F igure 85 on page 173l 
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Figure 85. My. Sample. Dynamic - advanced configuration: general page 



3 

4 



Leave the defaults in the General page. 



Select the Files tab. The Files page is displayed, as shown in |Figure 86 on 
Ipaqe 1741 
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Press FI at any time tor help. 



Figure 86. My. Sample. Dynamic - advanced configuration: files page 



Now you create two dynamic sections, the first one to install the sample1.dat file 
on a workstation with a disk space of 150 MB, the second to install the 
sample2.dat file on a workstation with a disk space of 200 MB. 

5 Enter sample1.dat in the Name field. 

6 Leave the default in the Action list. 

7 Click on the Open... push button. The Dynamic Sections - Definition notebook is 
displayed, as shown in Figure 87 on page 175l 
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Figure 87. Dynamic sections definition notebook: general page 

8 For Name, enter Dynamic 1. 

9 Click on the Conditions tab. The Conditions page is displayed, as shown in 
Figure 88 on page 176 
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Figure 88. Dynamic sections definition notebook: conditions page 



10 Fill in the entry fields contained in the Edit condition line group to define the first 
condition (DRIVE_SIZE < 180M), as shown in Figure 88. 

1 1 Click on the Add after push button. 

The condition is displayed in the Defined condition list. 



12 Close the notebook. The MY. Sample. Dynamic - Advanced Configuration 
notebook is displayed again. 

13 Click on the Add push button. 

The sample1.dat file and the corresponding Dynamic 1 dynamic section are 
displayed in the Files in software object container. 



14 

15 

16 



Enter sample2.dat in the Name field. 
Leave the default in the Action list. 



Click again on the Open... push button. The MY. Sampl e. Dynamic - Dynamic 
Sections - Definition notebook is displayed, as shown ir Fig ure 89 on page 177 
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Figure 89. Dynamic sections definition notebook: general page 

17 For Name, enter Dynamic 2. 

18 Click on the Conditions tab. The Conditions page is displayed, as shown in 
iFiqure 90 on page 178l 
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Figure 90. Dynamic sections definition notebook: conditions page 

19 Fill in the entry fields contained in the Edit condition line group, to define the 
second condition (DRIVE_SIZE > 180M), as shown in Figure 90. 

20 Click on the Add after push button. 

The condition is displayed in the Defined condition list. 

21 Close the notebook. The My. Sample. Dynamic - Advanced Configuration 
notebook is displayed again. 

22 Click on the Add push button. 

The sample2.dat file and the corresponding Dynamic 2 dynamic section are 
displayed in the Files in software object container, as shown in iFigure 91 on| 
page 179 
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iTj MY.Sam p I e Dy n amic- Advanced Configuration 



I 
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Action COPY FILES r 
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Open... 
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Files in software object 
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File 
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Dynamic 2 
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Scripts 



Variables 



Remote Direct 



SW Prereq. 



HW Prereq. 



Command 



Options 



Figure 91. MY. Sample. Dynamic - advanced configuration: files page 



23 Close the notebook. The New Software Profile window is displayed again, as 
shown in Figure 92. 



New Software Profile - Create Another 



Software Profile 
Name 

MY.Sample.Dynamic 
Configure As 

Configure... 

O Basic 1 

[• Advanced 

0 Put the object in catalog ready for distribution 
OK Cancel Help 



Figure 92. New software profile window 



24 Leave the check box checked and click on the OK push button to build the 
software object and put it into the Catalog. 
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25 A progress indicator is displayed, as shown in [Figure 93 on page 180[ 




Figure 93. Software object profiles progress indicator 

26 A Software Object Profiles informational message is displayed, as shown in 
Figure 94. 



Software Object Profiles 

O FNDSG028I: Software object 

IBM.SWPREP.052796. 1 620.REF. 100. 
1 was built and cataloged 
successfully. 




Help 



Figure 94. Software object profiles informational message 

27 Click on the OK push button, the Software Object Profiles window is displayed, 
containing the My. Sample. Dynamic object just created, as shown in Figure 95. 




Figure 95. Software object profiles window 

Now this dynamic software object is ready to be installed. 
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For the installation procedure see |“Scenario 2: Installing a Software Object to a Targetl 
|(Push Installation)” on page 161 



Scenario 4: Replicating an Installation with DiskCamera 

This scenario uses an example program called XLATOR, which is an application to be 
made available to other users. XLATOR does not have an installation program; 
installing it consists of copying the files in a directory and some subdirectories, and 
modifying the CONFIG.SYS. DiskCamera makes it easy to replicate this type of 
installation on multiple workstations. 

Using DiskCamera, you can: 

1 Take a picture of the drive and of selected system files 6 and workplace objects 7 
before and after you install an application manually on the workstation where you 
are doing software preparation 

2 Using the “before” and “after” pictures, create a software object, which you can 
catalog at the distribution server. Installing this software object on other 
workstations has the same effect as the manual installation. 

To use DiskCamera to install a software object you must install the operating system in 
the same directory path on both the preparation site and the target on which you want 
to install the software object. 

If one of the three steps that you perform using DiskCamera fails you must delete the 
\BIN\DSKCAM.TMP file before using DiskCamera again. 

You cannot use DiskCamera to install the WIN-OS/2 applications. 

Taking a “Before” Picture 

You first take a “before” picture of the E drive, install XLATOR there, and then take an 
“after” picture. Set aside the E drive for DiskCamera use only, to be sure that the only 
changes DiskCamera records are those resulting from the installation. For performance 



6 On OS/2, the default list of files monitored by DiskCamera is OS2INIT.CMD, OS2SYS.INI, OS2.INI, STARTUP.CMD, and 
CONFIG.SYS. On all Windows clients, CONFIG.SYS, AUTOEXEC.BAT, and all .INI files are monitored. On Windows 95, 

Windows 98, Windows NT and Windows 2000 clients the Registry is also monitored. You can change the list of files to be 
monitored (except for the Registry) by editing the file DSKCAM.INI in the TME 10 Software Distribution directory, \BIN subdirectory. 

7 On OS/2, each workplace object (icon, folder, launch pad, etc.) on the current desktop is monitored, provided it was created with an 
object ID. DiskCamera does not monitor workplace objects created without an object ID. 

On Windows 95 and Windows 98, DiskCamera cannot monitor direct creation of an icon on the desktop or in the Programs folder. 
To bypass this limitation, after you take the “before” picture, follow these steps: 

a. Install the product 

b. From Start, open the Programs folder and create a new folder with the product name 

c. Under this folder, create a new icon and link it to the related product executable file 

d. Then take the “after” picture. 
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reasons, it is important that the drive used for DiskCamera contains as few files as 
possible. 

To take the “before” picture, perform the following steps at the preparation site: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon folder is displayed, as shown 
in Figure 96. 



TME 10 Software Distribution for OS/2 
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Figure 96. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the Software Preparation icon. 

The Software Preparation folder is displayed, as shown in Figure 97. 



Software Preparation 



Selected View Help 



° □ 



1 


% 


1 


Generic Software 




CID Software 



Double click to create a generic software object profile 



Figure 97. Software preparation folder 
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3 Double-click on the Generic Software icon. The Software Object Profiles window 
is displayed, as shown in iFiqure 98 on page 183[ 




Figure 98. Software object profiles window 

4 Select Software from the menu bar. 

5 Select Using DiskCamera... from the New choice in the pull-down menu. 

The Create a software object profile using DiskCamera window is displayed, as 
shown in Figure 99. 




Figure 99. Create a software object profile using DiskCamera window 



6 Click on the first button (it is the only one available). 



The Take a picture of a disk drive window is displayed, as shown in jFigure 100 
|on page 184| 
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Figure 100. Take a picture of a disk drive window 

7 Select the E drive and click on OK push button. The first picture starts. 

A full-screen window is displayed showing which files are being monitored. This 
operation could take several minutes. 

8 An informational message informs you when the disk picture has been 
successfully completed. Click on the OK push button. The Create a software 
object profile using DiskCamera window is displayed again. 

Note that the first button of this window is now checked with a red check mark to 
indicate that the first step of the DiskCamera process has been completed. 

Now you must install the new application at the preparation site. 

Installing the Application at the Preparation Site 

XLATOR is stored on the C drive, under a directory named XLATOR. The XLATOR 
directory contains the following files: 

XLATOR\XLATOR.EXE 

XLATOR\DLL\XLATOR.DLL 

XLATOR\DOC\XLATORl.DOC 

XLATOR\DOC\XLATOR2.DOC 

To install the application on the E drive, follow the following steps: 

1 Make a directory XLATOR, with subdirectories DLL and DOC, on the E drive. 

2 Fr om an O S/2 prompt, copy the files to the E drive, as shown in [Figure 1 01 on| 
page 185 
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^ OS/ 2 Window 

OS/2 Ctrl+Esc = Window List Type HELP = help 

[C: \] e : 

[E : \] cd xla tor 

[E: \xlator]copy c: \xiator\xlator.exe 
1 file(s) copied. 

[E : \xlator] cd dll 

[E: \xlat or \dll] copy c: \xlator\dll\xlator.dll 

1 file(s) copied. 

[E: \xlator \dl l ] cd . . \doc 

[E : \xlator \doc] copy c : \xlator \doc\* . * 
c: \xlator \doc\XLAT0R1 . DOC 
c: \xlator \doc\XLAT0R2 . DOC 

2 file(s) copied. 

[E: \xlator \doc]_ 



>J 



Figure 101. Copying files to the DiskCamera drive 

3 Using the system editor, edit CONFIG.SYS to add XLATOR to PATH, LIBPATH 
and DPATH, as shown in Figure 102, and save the changes. 



E.EXE - config.sys 



File Edit Options Help 

1^1 

VO.FXF IgSIAfllil F :\FM 2; C:\N OTE S; 

F:\KAS E CPP\Q U I KTO U R; D :\N OTE S; C:\CMVC\EXE; C:\CMVC\EXE\SAM PLES;E : VKLA.T 0 R; 
\LANXCO PY; F :VXLAT OFLC:\CMVC\EXE;E : V<LAT 0 R; E :\FM 2; 

HELPjSETGLOS S ARY =C:\OS2\HE LP\G LOSS; C:\CMVC\EXE; E:\FM2; 



\<J l TE 

Figure 102. Editing CONFIG.SYS 

Now you are ready to take the “after" picture. 

Taking an “After” Picture 

After the installation is completed, the next step is to take the “after” picture of the 
installation drive and the files being monitored. Note that it is important to be sure the 
installation is complete before taking the “after” picture; if you need to change the 
installation, you will have to restart the DiskCamera process from the beginning. 
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It is also important to be sure all newly created and changed files are as you want 
them, and that no other processes running on your workstation have made unwanted 
changes. 

To take the “after” picture of the E drive and of several system files, follow the following 
steps: 

1 In the Create a software object profile using DiskCamera window (shown in 
F igure 99 on page 1831 click on the second button to notify DiskCamera that the 
installation has been completed. A confirmation message is displayed. Click on 
OK to continue. 

Note that the second button of this window is now checked with a red check mark 
to indicate that the second step of the DiskCamera process has been completed. 

2 In the Create a software object profile using DiskCamera window (shown in 
Figure 99 on page 183j click on the third button to generate the software object 
profile. 

3 The Software Object Profile Generator window is displayed. 

Fill in the fields of this window, as shown in Figure 103. 




Figure 103. Software Object Profile generator window 
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Name The name to appear on the object's icon in the Software 

Object Profile and Catalog windows. This is also the first 
part of the software object's name in the software 
distribution catalog. 

Component name The name of a specific component of a product 

Level A numeric field, normally the maintenance level of the 

product. It is the sixth part of the software object's name in 
the software distribution catalog. 

Version A numeric field, normally the version of the product. It is 

the seventh part of the software object's name in the 
software distribution catalog. 

To catalog the software object, check the Insert object in catalog check box (the 
default is "checked"). 

In this example you may want only to create the software object profile and 
catalog it later so remove the check mark from the check box. 

4 Click on OK. 

DiskCamera takes the “after” picture of the E drive and of the system files. It 
compares the “before” and “after” pictures and uses the differences to build a 
software object profile for XLATOR. 

A full-screen window is displayed showing which files have changed. This 
operation could take several minutes. 

A progress indicator is displayed, as shown in jFigure 82 on page 1 71 L 
An informational message is displayed, as shown in Figure 104. 







FNDVU88I 




FNDVU88I: Software Object Profile 


U 


successfully generated 


OK 


Help 



Figure 104. Informational message 



5 Click on the OK push button. The Create a software object profile using 



DiskCamera window is displayed, as shown in | Figure 105 on page 188 
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Figure 105. Create a software object profile using DiskCamera window 

Now all the buttons are checked. This means that the DiskCamera process has 
been completed. 

6 Click on Cancel. 

The creation of the XLATOR software object profile has been completed. 

The icon for XLATOR is displayed in the Software Object Profiles window, as 
shown in Figure 106. 



Software Object Profiles 



Software Catalog window Selected Edit View Help 

Wg 

XLATOR 



Select New to create a new software object profile 



Figure 106. Software object profiles window with XLATOR added 

Now you will check the files associated to the XLATOR software object profile. 
Furthermore you will change the drive where the XLATOR software object will be 
installed. 

7 Double-click on the XLATOR icon in the Software Object Profiles window. The 
XLATO R - Advanced Co nfiguration notebook is displayed, as shown in 
F igure 107 on page 189 
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Figure 107. XLATOR - advanced configuration notebook 

8 Click on the Files tab to see the list of files that have been included in the 

software object. The list is displayed in the Files in software object container, as 
shown in IFigure 108 on page 190| In this page it is possible to add, update, or 
delete files in the software object. 
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Figure 108. XLATOR - advanced configuration notebook: files page 



9 



To check the variables associated with 
tab. The Variables page is displayed, 



the software object, click on the Variables 



as shown in |Figure 109 on page 191 
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Figure 109. XLATOR - advanced configuration notebook: variables page 

In this case, the only variable is the target drive on which XLATOR is to be 
installed. 

To change the target drive: 

a. Select TargetDrive=E in the List of variables. 

b. Change E to C in the Value entry field. 

c. Select OS/2 in the Operating system list. 

d. Click on the Add push button. 

The TargetDrive=C item is displayed in the List of variables list. 

10 Close the XLATOR - Advanced Configuration Notebook. 



Cataloging the Software Object 

After confirming that XLATOR contains the correct files and changing the target drive, 
you are ready to catalog XLATOR. 



1. Select XLATOR in the Software Object Profiles window. 



2. Select Catalog from Catalog menu bar choice, as shown in Figure 1 10 on 
Ipage 192] 
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Figure 110. Software object profile window 
3. A progress indicator is displayed, as shown in Figure 111. 




Figure 111. Software object profiles progress indicator 
4. An informational message is displayed, as shown in Figure 112. 



Software Object Profiles 

O FNDSG028I: Software object 

IBM.SWPREP. 052796. 1 620.REF. 100. 
1 was built and cataloged 
successfully. 




Help 



Figure 1 12. Software object profiles informational message 



5. Click on the OK push button. 

An object for XLATOR is displayed in the TME 10 Software Distribution for OS/2 
Catalog window, as shown in |Figure 113 on page 193| 
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Figure 113. TME 1 0 Software Distribution for OS/2 catalog window 



For information about how to authorize clients to install cataloged applications (suc h as 
XLATOR) on request, see “Scenario 6: Defining and Authorizing a Client to Installl 



Software Objects” on page 205 



For information about how to request installation of a cataloged application (such as 
XLATOR) from an authorized client, se e |“Scenario 7: Installing an Application at a| 
Client (Pull Installation)” on page 211 



Note that the preparation site (MYPREP) and the target workstation (HFCLIENT) should 
have the same fix level of the operating system installed. 
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Scenario 5: Installing an Application from the Internet using DiskCamera 

In this scenario, you will: 

1 Download an application from the Internet 

2 Run the AntiVirus check 

3 Take a “before” picture of the drive where the application is to be installed 

4 Install the application, using DiskCamera to record the details of the installation 

5 Take an “after” picture of the drive 

6 Build the software object and catalog the application. 

Downloading the Application from the Internet 

The application used in this example is the PM Graphical File Management utility, 
which is also called FM/2. A sample window from FM/2 is shown in Figure 114. 




Figure 114. Sample File Manager window 
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To download the utility, follow these steps, using your Web Explorer: 

1 Open the Software Library - OS/2 Software page at the URL: 
ftp://hobbes.nmsu.edu/os2/di skutil 
as shown in Figure 115. 



i [j IBM WebExplorer - Index of /os2/diskutil 


° □ 


File Options Configure Navigate QuickList Help 
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ftp ://hobbes. nmsu.edu/os2/diskutil 





0 fm2_247.zip 2Q-Jun-96 07:32 1 . 3M 
EH fm2upg.zip 28-Jun-96 09:48 545K 
0 fm2utils.zip 07-Jun-96 07:38 441K 
0 forall72.zip 14-Dec-95 00:00 31K 
EH freel5.zip 31-Jan-95 00:00 15K 
0 fs2.zip 31-Jan-95 00:00 15K 
0 fst03e.zip 2 1 -May- 9 6 18:27 128K 
EH fstar99e.zip 31-Jan-95 00:00 700K 
EH gcpchgl0.zip 31-Jan-95 00:00 35K 
EH go2_12.zip 21-Jan-96 05:09 21K 
EH gtakl00.zip 31-Jan-95 00:00 202K 
EH gtakl00s.zip 31-Jan-95 00:00 153K 
EH hdspace.zip ll-Jun-96 01:55 79K 
EH hexdisp.zip 31-Jan-95 00:00 23K 
EH hexdumpl.zip 14-Dec-95 00:00 21K 
EH ho. zip 31-Jan-95 00:00 24K 
EH hobscdx.zip 31-Jan-95 00:00 27K 

[ml tr.nl -T-ir. 7 fc -M j. r- Q C. ISOt 1 



Figure 1 15. Downloading the application 

Select the fm2_247.zip utility and download it to a temporary directory. Be sure 
you download it on a drive different from the drive where you will install the 
application using DiskCamera. In this example, the application is downloaded to 
F:\TMP. 

2 Unzip the program with any shareware or commercial unzip program. If you do 
not have one, you can download it from the Info-Zip World Wide Web page at the 
URL: 

http://quest.jpl .nasa.gov/Info-ZIP/UnZip.html 

selecting one of the sites containing programs in OS/2 ready-to-run binary format. 
For example, you can choose: 

www.hensa.ac.uk (UK) 
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which points to the URL: 

http://www.hensa.ac.uk/ftp/mi rrors/uunet /pub/arch i ving/zip/0S2/ 

from which you can download: 

unz512x2.exe 

Run the unz512.exe self-extracting package to get the unzip.exe file that you 
need to unpack the fm.zip and install it. Place the unzip.exe under a directory 
specified by the PATH statement in your CONFIG.SYS. Unpack the fm2_247.zi 
into the F:\TMP directory with the command: 

unzip fm2_247.zip 

You now have the FM/2 files in the TMP directory. 

Now you are ready to run IBM AntiVirus. 

Running IBM AntiVirus 

To run a virus check on the program just downloaded, perform the following steps: 

1. Start the IBM AntiVirus program. The AntiVirus window is displayed, as shown in 
Figure 116. 




Figure 116. AntiVirus window 



2. Select Check system... in the Check menu choice. 



The Check system for viruses window is displayed, as shown in Fi gure 1 17 on 
Ipaqe 197] 
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Figure 1 1 7. Check system for viruses window 

3. Check the Selected drives/directories radio button and click on the first More- 
push button in the same group box. The Select drives/directories window is 
displayed, as shown in Fi gure 118 on page 198| 
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Figure 118. Select drives/directories window 



4. Set the drive and directory to be checked, in this example F:\TMP, and click on the 
OK push button. The Check system for viruses window is displayed again, as 



shown in Figure 117 on page 197 



5. Click on the OK push button. The AntiVirus window is displayed again, as shown 
on |Figure 1 16 on page 196| 



6. Click on the Push here push button. The AntiVirus program starts. A message is 
displayed indicating that the system scanning is in progress, then an informational 
message follows showing that the scan is completed. 



7. Click on the OK push button and close the AntiVirus program. 



Now you are ready to take the “before” picture and install the product. 



Taking a “Before” Picture 

Set aside a dedicated drive (in this example, E) for DiskCamera use only, to be sure 
that the only changes DiskCamera records are those resulting from the installation. For 
performance reasons, it is important that the drive used for DiskCamera contain as few 
files as possible. 



To take the “before” picture, open the Create a software object profile using 



DiskCamera window by following the first three steps of paking a “Before” Picture” on 
Ipage 18 i~l 



This window is displayed in |Figure 119 on page 199 
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Create a software object profile using DiskCamera 



Perform the following DiskCamera steps sequentially: 




Take a picture of a disk drive. 



How install your software product When the installation is 
complete, return to this window end dick on this icon 




Generate the software object profile. 



Cancel 



Help 



Figure 1 19. Create a software object profile using DiskCamera window 

1 Click on the first button (it is the only one available). 

The Take a picture of a disk drive window is displayed, as shown in Figure 120. 



Take a picture of a disk drive 



Select a disk drive *j 

To exclude user or system files from the picture, select the 



Advanced push button 






OK 


Advanced... 


Cancel 


Help 



Figure 120. Take a picture of a disk drive window 



2 Select the E drive and click on OK push button. The first picture starts. 

A full-screen window is displayed showing which files are being monitored, this 
operation could take several minutes. 

An informational message informs you when the disk picture has been 
successfully completed. 

3 Click on OK. The Create a software object profile using DiskCamera window is 
displayed again. 

Note that the first button of this window is now checked with a red check mark to 
indicate that the first step of the DiskCamera process is completed. 

Now you can install the application, downloaded from Internet, at the preparation site. 



Chapter 16. Software Distribution Scenarios 199 







Installing an Application from the Internet using 



DiskCamera 



Installing the Application on the Disk Camera Drive 

Run the installation program to install the application on the DiskCamera drive. Follow 
these steps: 

1 Open an OS/2 window, go to the F:\TMP directory, and run the install program 
install.exe, as shown in Figure 121. 




Figure 121. Issuing the install command 



2 The FM/2 Installation window is displayed, as shown in Figure 122 on page 201 
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FM/2 Installation 



Executable directory: 

E:\FM2 

INI directory: gj Install a default INI 

E:\FM2 

Archiver.BB2 directory: 

E:\FM2 

Help directory: 

E:\FM2 

g Append "SET FM2INI=..." to CONFIG.SYS 

ARCHIVER.BB2 directory is not listed in DPATH 
environment variable: 

(C:\IBMLAN\HETPROG;C:\MPTN\BIN;C:\ibmcom;D 
:\IBMCPP\BIN;C:\CPPDOC\HELP;D:\IBMCPP\SM 
ARTS\SCRIPTS;C:\MUGLIB;C:\OS2;C:\CMLIB;C:\ 
OS2\ SYSTEM; C:\OS2\MDOS\WINOS2; C:\OS2\l NS 
TALL;C:\;C:\OS2\MDOS;C:\OS2\APPS;C:\LAHXC 



Install 



Defaults Current 



Help 



Cancel 



Figure 122. FM/2 installation window 



3 Enter the name of your target directory E:\FM2. 

4 Answer Yes to the message that asks if you want to create the FM2 directory. 

5 Select the two check boxes to add a default INI file and to add to CONFIG.SYS 
the setting of the FM2INI environment variable. Click on Install. 

6 The installation program prompts you to decide whether or not you want a WPS 
object on your desktop. Select Yes and close the FM/2 - Setting notebook that 
is displayed. 

7 Verify that the icon of FM/2 is now on your desktop. 

8 Check your CONFIG.SYS. Notice that a line with the statement SET 
FM2 1 N I =E : \ FM2 was added at the end of the file. 

9 To complete the installation, update the PATH, DPATH, and HELP statements, 
adding the E:\FM2; directory. 

1 0 Save and close your CONFIG.SYS. 
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Taking an “After” Picture 

After the installation is completed, the next step is to take the “after” picture of the 
installation drive and the files being monitored. Note that it is important to be sure the 
installation is complete before taking the “after” picture; if you need to change the 
installation, you will have to restart the DiskCamera process from the beginning. 

It is also important to be sure all newly created and changed files are as you want 
them, and that no other processes running on your workstation have made unwanted 
changes. 

To take the “after” picture of the E drive and of the system files, follow the following 
steps: 

1 In the Create a software object profile using DiskCamera window (shown in 
Fi gure 99 on page 183t click on the second button to notify DiskCamera that the 
installation has been completed. A confirmation message is displayed. Click on 
OK to continue. 

Note that the second button of this window is now checked with a red check mark 
to indicate that the second step of the DiskCamera process has been completed. 

2 In the Create a software object profile using DiskCamera window (shown in 
Fi gure 99 on page 183j click on the third button (it is the only one available) to 
generate the software object profile. 

3 The Software Object Profile Generator window is displayed. 

Fill in the fields of this window, as shown in jFigure 123 on page 203[ 
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Installing an Application from the Internet using 



DiskCamera 



Software Object Profile Generator 



Software Object Profile 
Name FM2| 



Object label in catalog 

Component name IBM.SWPREP 



Level 1 1 00 

Version pj 

2j jnsert object in catalog, from where it can be distributed 



OK 



Cancel Help 



Enter the software object profile Version for the catalog label 



Figure 123. Software object profile generator window 

Name The name to appear on the object's icon in the Software 

Object Profile and Catalog windows. This is also the first 
part of the software object's name in the software 
distribution catalog. 

Component name The name of the component of the product. 

Level A numeric field, normally the maintenance level of the 

product. It will be the sixth part of the software object's 
name in the software distribution catalog. 

Version A numeric field, normally the version of the product. It will 

be the seventh part of the software object's name in the 
software distribution catalog. 

Leave checked the Insert object in catalog check mark to catalog the software 
object. 

4 Click on OK. 

DiskCamera takes the “after” picture of the E drive and of the system files. It 
compares the “before” and “after” pictures and uses the differences to build and 
catalog the software object for FM2. 
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DiskCamera 



A full-screen window is displayed showing which files have changed. This 
operation could take several minutes. 

5 A progress indicator is displayed, as shown in iFiqure 82 on page 171[ 

6 Then an informational message is displayed, as shown in Figure 124. 







FNDVU88I 




FNDVU88I: Software Object Profile 


© 


successfully generated 


OK 


Help 



Figure 124. Successful profile creation message 

7 Click on the OK push button. The Create a software object profile using 
DiskCamera window is displayed, as shown in Figure 125. 




Figure 125. Create a software object profile using DiskCamera 

In this window all the buttons are checked. This means that the DiskCamera 
process is completed. 

8 Click on Cancel. 

The creation of the FM/2 software object profile has been completed. 

T he icon for F M 2 is displaye d in the Software Object Profiles window, as shown 
in fFigure 126 on page 205l 
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Authorizing Client Installation 



Software Obiect Profiles 



Software Catalog window Selected Edit View Help 

S|f| 

FM2 



Select New to create a new software object profile 



Figure 126. Software object profiles window with FM2 added 

At this point the FM2 software object is cataloged and ready to be installed. 



Scenario 6: Defining and Authorizing a Client to Install Software Objects 

In this scenario you first define a client workstation and then you authorize it to install 
software objects. Then from this workstation, you install a software object, using pull 
installation. 

By default, a software object created at a server can be installed on request, without 
authorization, by other servers, but not by clients. A software object created at a client 
can be installed on request, without authorization, by that client and by servers, but not 
by other clients. You can change that default, and make all software objects available 
to be installed on request from all clients. 

In this scenario the default has not been changed. You define the HFCLIENT client 
workstation, as a target, from your HFSERVER server workstation and authorize the 
client to install a software object from the catalog of HFSERVER. 
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To define a target workstation, follow these steps: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 
shown in lFiqure 127 on page 206l 



KEf TME 10 Software Distribution for OS/2 


- Icon View 


:: □ 




1712 


2"S 


SD 




Software Distribution Server 


Tivoli Software Distribution 


Tivoli SD (3.1.5) 




Documentation 




Message Log 






& 


m\ 


i 




Tivoli SD (3.1.5) Tivoli APPC Configuration SmartGuides Tivoli Distribution Server 




SW Preparation 




Installation Utility 








cf 


si 




Tivoli Distribution Server 


Tivoli Distribution DataBase 


Tivoli Distribution DataBase 






Configuration 


Cleanup T ool 


Recovery Tool 






[iT| 


«Oli 






Stop Software Distribution 


Start Software Distribution 








Server 


Server 







Figure 127. TME 10 Software Distribution for OS/2 - icon view folder 



2 Double-click on the TME 10 Software Distribution icon. 

The TME 10 Software Distribution for OS/2 Logon window is displayed, as shown 



in 



Figure 128 on page 207 
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Software Distribution for OS/2 Logon 



The password will not be displayed 
User ID root 



° □ 



Password 



Server name HFSERVER 



Servers 



HFSERVER 



Logon 



Cancel 



Help 



Figure 128. TME 1 0 Software Distribution for OS/2 logon window 



3 Enter your user ID and password, and click on the Logon push button. 

The TME 10 Software Distribution for OS/2 Catalog window is displayed. 

4 In the TME 10 Software Distribution for OS/2 Catalog window, select Targets 
from the Windows menu bar. The TME 10 Software Distribution for OS/2 
Targets window is displayed, as shown in Figure 129. 



Software Distribution tor 0S2 Targets (root at HFSERVER) 



Target Selected View Windows Help 

Name Type OS Description 



HFSERVER this (push) OS/2 INITIAL TARGET CONFIGURATiOtJ RECORD 



MYPREP Client (push) OS/2 My Preparation Client 



1C 



Figure 129. TME 10 Software Distribution for OS/2 targets window 
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5 Select New target... from the Target menu bar choice. The New Local Target 
window is displayed, as shown in iFiqure 130 on page 208| 




Figure 130. New local target window 



6 Fill in the fields as shown in Figure 130. 

Note that the target address and LAN address fields must be filled in with specific 
data related to the client workstation that you are defining. 



Name 

Description 
Target address 

LAN address 
Target type 
Server name 
Target OS 



Name of the target workstation. 

Brief description of the target workstation. 

Address of the target workstation (depends on the 
communications protocol that you choose by clicking on the 

Protocol Type... push button). 

LAN address of the target workstation. 

Type of the target workstation. 

Name of the distribution server for the target workstation. 
Operating system of the target workstation. 
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Domain Address 
Access Key 
Password 

Verify Password 



Address of the domain to which the target belongs. 

Access key assigned to the target. 

Password to be used to access the target. You must enter 
it every time you issue a command. 

A check of the password entered under Password. 



7 Click on the OK push button and the TME 10 Software Distribution for OS/2 
Targets window is displayed, as shown in Figure 131. 



Software Distribution for OS2 T argets (root at HFSERVER 



Target Selected View Windows Help 



Name 


Type 


OS 


Description 


^ |OTma|| J 




OS/2 


My new client 


HFSERVER 

MYPREP 


this [push) 
Client (push) 


OS/2 

OS/2 


INITIAL TARGET CONFIGURATION RECORD 
My Preparation Client 







J 



Figure 131. TME 1 0 Software Distribution for OS/2 targets window 



The HFCLIENT client workstation is now defined. 

Now you are ready to authorize this client to install software objects from the 
HFSERVER server workstation. 

8 Select Catalog from Windows menu choice. The TME 10 Software Distribution 
for OS/2 Catalog window is displayed, as shown in Figure 132. 



IK Software Distribution for 0S2 Cataloq (root at HFSERVER) 


1 ° 


a 


Catalog Selected View System Distribution Engine Windows Help 


Global File Name 


Description 






IBM.FM2.REF. 100.1 


File Manayer/2 




J 


1 BM. M Y. SAMPLE. DYNAM 1 C. REF. 1 0 0 . 1 


MY. Sample. Dynamic 






IBM.MY.SAMPLE.REF. 100.1 


MY.Sample 




IBM.MY.SAMPLE.REMOTE.REF. 100.1 


My. Sample. Remote 






IBM. SV4W. SERVER. REF.1. 0. US 


SystemView Server 






IBM.XLATOR.REF. 100.1 


XLATOR 




J 


1 




— 





Figure 132. TME 10 Software Distribution for OS/2 Catalog window 

9 Select the IBM. MY. Sample. REF.1 00.1 software object. 

10 Select Authorize... fro m the Selected pull-down. The Authorize Files window is 
displayed, as shown in lFiqure 133 on page 21 0| 
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IBM.MY.SAMPLE.REF. 100.1 



Targets 



I Client [push] My new client 



HFSERVER this (push) INITIAL TARGET CONFIGU 
MYPREP Client (push) My Preparation Client 



Schedule 
Execution 
Not before : 
Not after : 



Immediately 



When received by target 
Undefined 



Procedure 



Find... Target HFSERVER 



Figure 133. Authorize files window 



1 1 Select HFCLIENT in the Targets list and click on the Authorize push button. The 
Correlators window is displayed, as shown in Figure 134. 




Figure 134. Correlators window 



12 Click on the OK push button. The Authorize Files window is displayed again. 

13 Click on the Close push button. 
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Now the HFCLIENT client workstation is authorized to install the 

IBM. MY. Sample. REF.1 00.1 software object. 



Scenario 7: Installing an Application at a Client (Pull Installation) 

After a client has been authorized to install an application, a user at the client can 
request the installation. To request installation of an authorized application from a 
client, follow these steps at the client workstation: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 
shown in Figure 135. 



£5 TME 10 Software Distribution for OS/2 - Icon View H 





Start Software Distribution 
Client 




Stop Software Distribution 
Client 

m 



Tivoli Distribution Client 
Configuration 




Tivoli Distribution Client 
Installation Utility 




Tivoli SD Client (3.1.5) 
Message Log 



Tivoli APPC Configuration SmartGuide 



Dme 



Tivoli SD Client (3.1.5) 
SW Preparation 



Tivoli Software Distribution 



Tivoli Distribution Client 
Documentation 



Figure 135. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the TME 10 Software Distribution icon. 

The TME 10 Software Distribution for OS/2 Logon window is displayed, as shown 
in [Figure 136 on page 21 2| 
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Software Distribution for OS/2 Logon 



O □ 



The password will not be displayed 
User ID root 



Password 



Server name 



Servers 



HFSERVER 



Logon 



HFSERVER 



Cancel 



Help 



Figure 136. TME 10 Software Distribution for OS/2 logon window 

3 Enter your user ID and password, and click on the Logon push button. The 
TME 10 Software Distribution for OS/2 Catalog window is displayed, as shown in 
Figure 137. 



Software Distribution for 0S2 Catalog (HFCLIENT at HFSERVER) 



Catalog Selected View System Distribution Engine Windows Help 

Global File Name Description 

IBM.FM2.REF. 100.1 File Manager/2 

I BM. M Y. SAMPLE. D YHAM I C. REF. 1 0 0 . 1 MY. Sample. Dynam i c 



I BM. MY. SAMPLE. REFi 100. 1 MY.Sample 



IBM.MY.SAMPLE.REMOTE.REF. 100.1 My.Sample.Remote 

IBM.XLATOR.REF.100.1 XLATOR 



Figure 137. TME 10 Software Distribution for OS/2 Catalog window 

4 Select the IBM. MY.Sample.1. REF. 100.1 software object. 
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5 Select Install from the Selected pull-down. The Install Change Files window is 
displayed, as shown in lFiqure 138 on page 2131 




Figure 138. Install Change Files window 

6 Click on the Install push button. The Correlators window is displayed, as shown 
in Figure 139. 




Figure 139. Correlators window 
7 Click on the OK push button. 

The pull installation of the IBM. MY. Sample. 1. REF. 100.1 software object on the 
HFCLIENT client workstation is completed. 
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Chapter 17. Setting Up for CID Preparation 



Using the CID (configuration, installation, and distribution) methodology, you can install 
CID-enabled software products on unattended workstations. The CID software 
preparation function assists you in creating the files that are necessary to perform the 
unattended installation. 



The CID methodology makes use of a response file. A response file is a file that 
contains predefined answers to the questions asked by the installation program during 
an attended installation. TME 10 Software Distribution CID software preparation can 
generate the response file or can use a response file that already exists. 



TME 10 Software Distribution CID software preparation is based on the information 
contained in a file called an application definition file (ADF), which defines how to 
configure and install the specific product. Before you can prepare a CID-enabled 
software product for distribution, you must have an ADF for the software product. 
Various products ship ADFs on their di stribution media. In some cases you mig ht 
choose to create your own ADFs. See lAppendix F , “Application Definition File 



Considerations” on page 275| for considerations about ADFs. 



CID Software Distribution Environment 

The CID software distribution environment includes workstations playing four different 
roles, as shown in Figure 140. 



Code Server 

- Redirection Server 

(for example, LAN Server) 

- Sample CID Directory Structure 

• C:\CID\IMG ► ALIAS 

• C:\CID\RSP ► ALIAS 

• D:\LOGINST\LOG ► Name 



Distribution Server 




Distribution Client 
- Redirection Client 
(for example, LAN Requester) 



Software Preparation Site 



Figure 140. Logical LAN environment for CID distribution 



© Copyright IBM Corp. 1993, 2000 
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CID Software Distribution Environment 



• Code Server 

This workstation is a repository for the code images and the response files of the 
products to be installed, and for a log of messages from CID installations, stored in 
a predefined directory structure. TME 10 Software Distribution does not 
necessarily have to be installed on the code server workstation. In deciding 
whether or not to put the code server on the same workstation as the distribution 
server, the factors to consider include storage requirements for the code images 
and whether multiple distribution servers will be sharing the code server. 

On the code server you must have installed the redirection software needed to allow 
clients to access the images and the response files during CID installation. The 
redirection software can be any one of the following: 

- IBMLS (LAN Server) 

- NFS (Network File System) Server (distributed with TCP/IP for OS/2) 

- SRVIFS (distributed with LAN Server) 

- NetWare Server 

• Distribution Server 

This is a workstation where the TME 10 Software Distribution server is installed. 
The catalog of software available to be installed is maintained at this workstation. 
The administrator initiates installation of software to distribution clients from this or 
any other TME 10 Software Distribution server workstation. 

• Preparation Site 

This is a workstation where the TME 10 Software Distribution server or client, 
including the preparation site component, is installed. At the preparation site, users 
prepare the software to be installed and catalog it on the distribution server. 

• Distribution Client 

This workstation is the target of the CID installation. It can be unattended during a 
CID installation. The distribution client has the TME 10 Software Distribution 
Client and the redirection software needed to access the code images and 
response files that are on the code server. The redirection software can be any 
one of the following: 

- LAN Requester 

- Network File System (NFS) client 

- SRVIFS client 

- NetWare client 




In the scenarios in the rest of this chapter, the code server, distribution server, 
and software preparation site are the same physical workstation. F igure 140 on| 



page 215 shows a LAN environment where these functions are on separate 



workstations. 
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Running the Code Server Setup Utility at the Preparation Site 



Overview of the Steps 

Your CID setup, preparation, and installation activities will take place in the following 
phases in the following sequence: 



1 Running the code serv er setup utility at the preparation site. You p erform 
this step only once . See l“Runninq the Code Server Setup Utility at thel 
Preparation Site.” 

2 Completing the setup on the code server workstation (required if the 
redirection software is not IBM LAN Server). You perform this step only once. 
See [“Completing the Setup on the Code Server Workstation” on page 224[ 



Adding product images and response files on the code server after initial 
setup. See |“Uploading Software Images to the Code Server” on page 226|f or 



automated uploading using the upload software images utility, and “Copying 



Products on the Code Server” on page 231 | for manual copying on the code 



server. 



4 Preparing and cataloging the software products to be distributed. 

5 Distributing and installing the software products. 



Running the Code Server Setup Utility at the Preparation Site 

This section shows how to specify, at the TME 10 Software Distribution preparation 
site, the redirection mechanism you will use during CID installation, the name of the 
code server, and aliases for the CID directory (where code images and response files 
are stored) and the LOGINST directory (where installation messages are stored). If you 
do not perform this step, you are prompted to do it during CID software preparation. 

If your redirection software is IBM LAN Server, in this step TME 10 Software 
Distribution performs automated code server setup. 



To start the code server setup, perform these steps: 

1 Double-click on the product icon. 

The TME 10 Software Distribution for OS/2 - Icon View folder is displayed, as 



shown in jFigure 141 on page 218 
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TME 10 Software Distribution for OS/2 - Icon View Q 




Tivoli Software Distribution Tivoli SD (3.1.5) 
Message Log 





Software Distribution Server 
Documentation 




Tivoli SD (3.1.5) Tivoli 
SW Preparation 




Tivoli Distribution Server 
Configuration 



APPC Configuration SmartGuides 

ef 

Tivoli Distribution DataBase 
Cleanup T ool 



Tivoli Distribution Server 
Installation Utility 




Tivoli Distribution DataBase 
Recovery Tool 




Stop Software Distribution 
Server 



Start Software Distribution 
Server 



Figure 141. TME 10 Software Distribution for OS/2 - icon view folder 

2 Double-click on the Software Preparation icon. 

The Software Preparation folder is displayed, as shown in Figure 142. 



Software Preparation 



Selected View Help 



1 


St.f 


1 


Generic Software 



c5V 

i~ii"Q 

(Si 

CID Software 



Double click to create a generic software object profile 



Figure 142. Software preparation folder 



3 Double-click on the CID Software icon. 

The CID S oftware Preparation window is displayed, as shown in |Fiqure 143 on| 
Ipaqe 21 9| 
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CID Software Preparation 



« □ 





i 


g 

j *j 







s 



Software Configurations 

15 



Code Server Setup Utility Upload Software Images 
Contains all CID software product definitions 



Figure 143. CID software preparation window 



4 Double-click on the Code Server Setup Utility icon. 

The Code Server Setup Utility notebook is displayed, as shown in Figure 144. 




OK 




Cancel 




Help 





Figure 144. Code server Setup Utility Notebook 



5 Click on the Setup tab or on the right arrow to proceed. Be sure you select all the 
listed variables and either accept or change each default value. The explanation 
area shows, for each selected variable, the information on how to set it. 
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P- 

=j3 

=p 

1 



Code Server Setup Utility 



. □ 



Variables 

Code Server Name 
CID directory alia: 
LOG directory alit 



Explanation 



Settings 

NFS 

SRVIFS 



NetWare Req 
No Redirection 



View 







Setup 


1 




IBMLS 



Select the type of redirection 
mechanism used by the Distribution 
Agent. 

Possible values are 

- Network File System (NFS), 

- Qo.'ior IFQ f<3D\/IF<;l Innlii fnr fl<5/9 

j=j3 — _ — . . 

Fj^ Undo Default 



Setup common distribution 






lo 




Cancel 





Help 



Figure 145. Type of redirection setting 



Specify the type of redirection. Note that if the code images and response files 
are on the local workstation where the product is going to be installed, no 
redirection is necessary; in this case, select No Redirection and specify local 
directories for the CID and LOG aliases. 
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Code Server Setup Utility 



Type of Redirectii 

CID directory alia: 
LOG directory ali; 



Settings 

CODESERV 



Explanation 



Enter the 


name of the code server 


containing the product images. 


depending 


on the type of redirection you 


selected. 


NhS 


- Host name 


CDVIFQ 


- QOVIFQ Qomor nomo v 



Undo Default 

3 I — I 

Setup common distribution 






OK | | Cancel Help 

Figure 146. Code server name setting 

Specify the code server name (in this example, CODESERV). 



Variables 

Type of Redirectii 
Code Server Name 

NIil.ltMffll'EfTE 

LOG directory alii 



Settings 

CIDlMGj 



Setup 
| jBMLS 



Explanation 

Enter the following values depending on 
the type of redirection you selected: 

HFS - The fully 

qualified name of the exported directory 
containing IMG and RSP 

QDVIFC IRMI Q NetWare Pen - The 



Undo Default 

3 l i 

Setup common distribution 



\±L* 



| OK | | Cancel Help 

Figure 147. CID directory alias setting 
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Specify the alias for the CID directory (in this example, CIDIMG). This is the 
directory where code images and response files are stored. 




Figure 148. LOG IN ST directory alias setting 



Specify the alias for the LOGINST directory (in this example, LOGMSG). This is 
the directory where messages from CID installations are to be stored. 

Set variables for automatic code server setup (IBM LAN Server only). 

If you did not select IBMLS as the redirection software, skip this step. 

If you selected IBMLS as the re direction software (see Rgure 145 on page 220 b , 
go to the IBMLS page, shown in Figure 149 on page 223 
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Running the Code Server Setup Utility at the Preparation Site 




Figure 149. IBM LAN server setting 

On this page you set variables to allow the code server setup utility to 
automatically generate and run a command file that performs the following setup 
activities on the code server workstation: 

• Create the base CID directory structure. 

• Create the aliases for the directories CID and LOGINST. 

• Create access profiles for the directories. 

• Authorize the IBM LAN Server user group USERS to read the files in the 
directory CID. 

• Authorize the IBM LAN Server user group USERS to write in the directory 
LOGINST. 

The variables are: 

a Run Setup 

Select Yes if you want to generate and immediately run the command file to 
set up the code server. Select No if you want to generate the command file 
and run it later. The file generated, CSSETUP.CMD, is stored in the 
directory: 

<TME 10 Software Distribution Installation Dri ve>: \SOFTDIST\BIN 

b Drive for images 
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The letter of the drive (on the code server workstation) on which 

TME 10 Software Distribution is to create the CIDMMG directory (for code 

images) and the CID\RSP directory (for response files). 

In these scenarios use the read-only spin button to select C because you 
want TME 10 Software Distribution to create the directories: 

C:\CID\IMG 

C:\CID\RSP 



C Drive for log messages 

The letter of the drive (on the code server workstation) on which 
TME 10 Software Distribution is to create the LOGINST\LOG directory. 

In these scenarios select D because you want TME 10 Software 
Distribution to create the directory: 

D:\L0GINST\L0G 



7 Click on OK to close the notebook. 



If you selected Yes for Run Setup in | Figure 149 on page 223| in the previous 
step, then automatic code server setup runs at this time. 



Completing the Setup on the Code Server Workstation 

If your redirection software is not IBM LAN Server, or if you chose No redirection 
when you ran the code server setup utility, perform the following steps. For LAN 
Server, the code server setup utility already performed these steps. 



1 Create the CID directory structure at the code server workstation. 



The code server directory structure consists of a CID directory with IMG and RSP 
subdirectories, and a LOGINST directory with LOG subdirectories. IMG, RSP, and 
LOGINST contain, respectively, the product code images, the response files, and 
the message log files. 



Figure 150 on page 225| shows a generic view of the recommended directory 
structure. 
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Completing the Setup on the Code Server Workstation 



<drive>: 

las=i==yp|ciD 

► IMG 

► <PRODUCT1> 

7 ► <PRODUCT2> 

' ► <PRODUCT N> 



► RSP 

► <PRODUCT1> 

T ► <PRODUCT2> 

' ► <PRODUCT N> 

<drive>: 

► LOGINST 

► LOG 

► <PRODUCT1> 

T ► <PRODUCT2> 

' ► <PRODUCTN> 



Figure 150. Recommended directory structure for CID distribution 
Follow these steps to create the directory structure: 
a Create the directories to store the code images. 

Open an OS/2 window and enter the following commands from drive C: 

MD CID 
MD CID\IMG 

b Create the directories to store the response files. 

Enter the following commands from drive C: 

MD CID\RSP 

C Create the directories to store the log files. 

Enter the following commands from drive D: 

MD LOGINST 
MD LOG I NST\ LOG 

2 Customize the redirection mechanism by setting the name of the code server and 
aliases for the CID directory and LOGINST directory. (If you chose No 
Redirection when you ran the code server setup utility, skip this step.) 

Customizing the redirection mechanism means setting up aliases for the 
directories C:\CID and D:\LOGINST, and naming the code server. The aliases 
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Uploading Software Images 



and code server name will be used during CID software preparation (see 
|“Runninq the Code Server Setup Utility at the Preparation Site” on page 21 7 \ . At 
this stage you also set read authorization for the directory: 

C:\CID 

and read-write authorization for the directory: 

D:\L0GINST 

and define the users. 

The steps to customize the redirection mechanism depend on the redirection 
software you installed. See the documentation for your redirection software. 



Uploading Software Images to the Code Server 

There are two ways to add a product to the code server. If the product is shipped with 
an application definition file (ADF) on CD-ROM or diskette, use the Upload Software 
Images utility program, which is explained in this section. Otherwise, add the product 
manually, as explained under |“Copying Products on the Code Server” on page 231 

The Upload Software Images utility program is available to: 

• Create the directory structure for the product on the code server 

• Copy the product images to the code server 

• Add the product to the software library 

• Optionally, create a default configuration for the product and catalog the software 
object. 

To upload the images of a product from CD-ROM to your code server, complete the 
following steps: 

1 In the CID Software Preparation window, double-click on Upload Software 

Images. The Upload Software Images - Setup window is displayed, as shown in 
Fi gure 151 on page 227| 
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Uploading Software Images 




Figure 151. Upload software images - setup window 

2 Select Diskette or CD-ROM and the letter of the diskette or CD-ROM drive. Click 
on OK. The Upload Software Images Setup - In Progress window is displayed, 
as shown in Figure 152. 



Upload Software Images Setup -In Progress 



Connect to Code Server... 

0% 20% 40% 60% 80% 100% 



Stop 



Help 



Figure 152. Upload software images setup - in progress window 

3 The utility scans the diskette or CD-ROM for application definition files that 
contain all the information necessary to upload software images. The list of 
products is displayed in the Upload Software Images window, as shown in 
iFigure 153 on page 228] 
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Next to each product is the default name of the directory that will be created 
under \IMG, \RSP, and \LOG on the code server. To change the directory name, 
click on Change dir... 




Figure 153. Upload software images window 



Select the product you want to upload. In this scenario you upload, from a 
CD-ROM, code images of a CSD to be applied to the TME 10 Software 
Distribution product. 



4 Select TME 10 Software Distribution for OS/2. Check the Create and catalog 
default configurations check box to create the server, client, and mobile client 
software object to upgrade the components. Then click on Upload as shown in 
Figure 153. 



5 



A message is 
on the server. 
CSD level, as 



displayed asking you if you want to overwrite 
Click on Yes to upgrade the code i mages on 



shown in Figure 154 on page 229 



the 

the 



image directory 
code server to the 
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Figure 154. Upload software images overwrite message window 

The Upload Software Images for TME 10 Software Distribution - In Progress 
Window i s displayed. When the up load has completed, a message appears as 
shown in iFigure 155 on page 230| 
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Figure 155. Upload software images message window 

Click on OK. The Upload Software Images window is redisplayed with a modified 
icon for uploaded product, as shown in Figure 156. 




Figure 156. Upload software images message window after upload of the code images 
6 Click on Close to finish. 
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7 In the CID Software Preparation window, double-click on Software Library. Note 
that an icon for the uploaded product has been added to the Software Library 
window. 

8 In the CID Software Preparation window, double-click on Software 
Configurations. 



Software Configurations 



Selected Edit View Help 




Tivoli Software Distribution - Mobile Client update 




Tivoli Software Distribution - OS/2 Client update 





Wf 




Tivoli Software Distribution - Server update 



Select Catalog from the Selected pull-down to make an object available for installation 



Figure 157. Software configurations window 



You can see the server, client, and mobile client configurations. Three new 
software objects have been created in the server catalog. You can install these 
software objects to upgrade the TME 10 Software Distribution server, client, and 
mobile client workstations to the new CSD level. Then you must migrate the 
server and the mobile client database as described in the README file of the 
CSD. 



Copying Products on the Code Server 

If the software product you want to add to the code server is not distributed with an 
ADF on CD-ROM or diskette, add the product to the code server manually, as 
explained in this section. 

This section makes use of a fictitious application program, CASHFLO. To actually run 
the scenario, you need to have a real application with an ADF to add to the code 
server. 



Follow these steps: 



1 Create the product-specific subdirectories under the base CID directory structure 
at the code server workstation. 



Figure 150 o n page 225| shows the complete CID directory structure for several 
software products. Under the IMG, RSP, and LOG directories already created on 
the code server, add a subdirectory for each software product. 
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For example, assume that CASHFLO is a product with a client/server structure. 
To create the subdirectories to store the CASHFLO client on the code server, 
perform the following steps: 

a Create the subdirectories to store the code images and response files. 

Open an OS/2 window and enter the following commands from drive C: 

MD C I D\ I MG\CASH FL0\C LI ENT_2 
MD CID\RSP\CASHFL0\CLIENT_2 

b Create the subdirectory to store the log files: 

Enter the following command from drive D: 

MD LOGI NST\LOG\CASHFLO\CLI ENT_2 

2 Copy product images and response files under the subdirectories. 

Before you install any software on the clients, you must copy the product code 
images to the code server hard disk. The images are then made available to the 
clients through a redirection mechanism. Many products provide a utility for 
copying the images to a server. Others provide a documented procedure, often 
using the XCOPY command, to copy the images. 

Refer to the product documentation for a detailed explanation of how to copy the 
product images. Copy the images for the products you intend to distribute. 

For the hypothetical CASHFLO program, perform the following steps to copy the 
images and supplied response file from the CASHFLO CD-ROM: 

a Insert the CD-ROM containing CASHFLO into the CD-ROM drive. 

b Open an OS/2 window and enter the following command: 

XCOPY <CD-R0M source dri ve> : \CASH FL0\C LI ENT_2 C:\CID\IMG\CASHFL0\CLIENT_2 /S 
C Enter the following command to make the files updatable: 

ATTRIB C:\CID\IMG\CASHFL0\CLIENT_2\*.* -R 

Now you are ready to add CASHFLO to the software library. 

Adding Products to the Software Library 

If you added a product to the code server manually, you must also add it to the 
TME 10 Software Distribution software library at the preparation site before you can 
prepare it for CID installation. 

To add a software product to the library, perform these steps at the preparation site: 

1 Start TME 10 Software Distribution from the OS/2 desktop. 

2 Double-click on the CID Software Preparation icon. 

3 Double-click on the Software Library icon. 

The Software Library window is displayed. 
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4 Select Software from the menu bar. 

5 Select New... from the pull-down menu if the ADF is not in the SWLIB directory. 8 

The New Software window is displayed. Enter the name of the new software 
product and the fully qualified name of the application definition file as shown in 
Figure 158. 



New software 



Name CID Product VI. 1 



Definition file 



g:\CIDPRV1 1 . ADF| 









Find... 



Add 



Cancel 



Help 



Figure 158. New software window 

To search for the application definition file, in this example CIDPRV1 1 .ADF, select 

Find. 

6 Select Add to associate the application definition file with the software product 
being added to the TME 10 Software Distribution software library. 

7 Select Close to exit. 

In this example the software product CID Product VI. 1 is added to the Software 
Library window and the related application definition file, CIDPRV11.ADF, is 
associated with it. 



8 If the ADF is in the SWLIB directory, click on Load all, and the product is added to the software library. 
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Part 4. Appendixes 



This part contains information to which you may need to refer from time to time while 
using TME 10 Software Distribution. The appendixes are: 

• Ap pendix A, “Installing TME 10 Software Distribution by Response File” on| 
page 237| 

• Appendix B, “Implementin g Inventory Discovery” on page 247 

• lAppendix C, “Replacing the Quiesce Check” on page 253| 

• Ap pendix D , “Writing Change Control Scripts” on page 255l 

• Appendix E, “Writing User Exits” on page 259 

• |Appendix~ F, “Application Definition File Considerations” on page 275| 

• Appendix G, “Setting Environment Variables” on page 281 



© Copyright IBM Corp. 1993, 2000 



235 



236 Quick Beginnings 




Appendix A. Installing TME 10 Software Distribution by Response 
File 



Because TME 10 Software Distribution conforms to the rules of the IBM configuration, 
installation, and distribution (CID) methodology, you can install TME 10 Software 
Distribution itself in an unattended fashion. This means that you can enter into a 
response file all the information for which you would otherwise be prompted during 
installation and configuration. 

You can use response files to install TME 10 Software Distribution from the CD-ROM 
or from a redirected drive. 

The following sections describe how to install the TME 10 Software Distribution server 
automatically and how to write response files that configure the TME 10 Software 
Distribution server options. 

Using the Installation Command 

The INSTALL command is available to install the server. 

Enter INSTALL followed by the installation parameters at the command prompt of the 
CD drive. To install TME 10 Software Distribution in unattended mode, add the /X 
parameter. 

Parameters can be in any order. Values can be in upper- or lowercase. You can use 
an equal sign (=) or colon (:) with the parameters. (The following syntax uses the : 
format.) 

The parameters are: 

/A:<action> 

/C:<catalog file name> 

/L1:<message log> 

/L2:<history log> 

/L3:<unattended configuration error log> 

/0:<originating system> 

/P:<product name> 

/Rxresponse file> 

/S:<source location> 

/T:<installation target location> 

/TU:<update CONFIG.SYS> 

/X interactive flag> 
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The definition for each command prompt parameter is: 

/A:<action> 

Specifies the action for INSTALL to execute. Possible values for this parameter 
are: 

D To Delete 

I To Install 

R To Restore 

U To Update 

If you omit this parameter, the installation starts interactively with all windows 
displayed. 

If you specify D, be sure no TME 10 Software Distribution processes are active, 
or the deletion will fail. 

/C:<catalog file name> 

Specifies the name and location of the catalog file that you want to be opened 
automatically. This is not a required parameter; if you do not enter it, the default 
catalog file is opened. 

/L1:<message log> 

Specifies the drive, path, and file name of the installation log file for information, 
warning, and error messages. All lines logged to this file are prefixed with a time 
stamp. 

/L2:<history log> 

Specifies the drive, path, and file name of the installation history log file. All lines 
logged to the history file are prefixed with a time stamp. 

/L3:<unattended configuration error log> 

Specifies the drive, path, and file name of the log for error and warning 
messages issued during an unattended configuration. 

/0:<originating system> 

Specifies the originating system of the installation. The value for this parameter 
is DRIVE. 

/P:<product name> 

Provides the name of the product for the specified action. The value must be 
TME 10 Software Distribution for OS/2, enclosed in double quotation marks. 

/R:<response file> 

Specifies the drive, path, and name of the response file you are using to drive the 
installation. 

/S:<source location> 

Specifies the drive and path containing the source files to install. You can omit 
this parameter if you run INSTALL from that same location. Omit this parameter 
if /A is set to D for delete. 
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/T:<installation target location> 

Specifies the drive and path where TME 10 Software Distribution is to be 
installed, or from which it is to be deleted if /A is set to D for delete. The default 
is <drive>\SOFTDIST. 

/TUxupdate CONFIG.SYS> 

Specifies the drive and path of the CONFIG.SYS to be updated by INSTALL. Be 
sure to include a backslash at the end of the path; for example, code: 

/TU:C:\ 

/X 

Specifies that the action is unattended. This parameter is required for 
unattended installation. 



Response File Layout 

A response file is a flat ASCII file that consists of a series of lines separated by new 
line sequences. You can write or edit a response file with any editor. 

Each line in a response file has a maximum length of 255 bytes. 

Response file lines have the following syntax: 
keyword = value 

Keywords cannot contain embedded spaces. 

|“Response File Keywords”| explains what the keywords mean. If the value of a keyword 
is shown in the form $(value), s ubstitute your own value or, for optional keywords, 
accept the default shown under |“Response File Keywords.” 

To include a comment line, place a semicolon (;) as the first character on the line. 



Response File Keywords 

In this section, the response file keywords are grouped into the following types: 

• Installation definition 

• General parameters configuration 

• Software distribution configuration 

• Enterprise connectivity 

Installation Definition Keywords 

CFGUpdate 

Specifies whether the system CONFIG.SYS file is to be automatically updated at 
installation. The value can be: 

Auto 

To update 
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Manual 

Not to update 

Type: Required 

COMP 

Specifies the names of the TME 10 Software Distribution server or client 
components that you want to install. Use one COMP keyword for each 
component. 

Possible component names for a server are: 

Distribution Server 

Is the TME 10 Software Distribution product. 

Distribution Server GUI 

Is the interactive server interface. 

Preparation Site Server GUI 

Adds the capability to prepare objects for software 
distribution by using the graphical interface. 

Hw/Sw Discovery Tool 

Adds the capability to do hardware and software inventory 
discovery on the workstation. 

Distribution Server Documentation 

Is the INF version of the product publications and other 
information files. 



DeleteBackup 

Specifies whether to delete any backup versions of TME 10 Software 
Distribution. The value can be yes or no. 

Type: Required 

File 

Provides the new default path for the TME 10 Software Distribution file directory. 
Type: Required 

Overwrite 

Specifies whether to automatically overwrite files during installation. The value 
can be yes or no. 

Type: Required 

SaveBackup 

Specifies whether to save a backup version of TME 10 Software Distribution 
when it is updated. The value can be yes or no. 

Type: Required 

Work 

Provides the new default path for the TME 10 Software Distribution data 
directory. 

Type: Required 
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General Parameters Configuration Keywords 

Driver 

Specifies the protocols used by the workstation to communicate with other 
machines in the TME 10 Software Distribution network. 

At least one of the following Driver keywords is required in the response file: 

• Driver.TCPIP 

• Driver.NetBIOS 

• Driver. IPX 

• Driver.SNA 

The value is 1 if the protocol is used and 0 if it is not used. You can specify 
more than one driver. 

Type: Required. 

SystemName 

Name of this system in the TME 10 Software Distribution environment. 

Type: Required 

Distribution Configuration Keywords 

BackupArea 

Is the new default path for the backup directory. The default is 
<drive>\SOFTDIST\BACKUP. 

Type: Optional 

Repository 

Is the new default path for the repository directory. The default is 
<drive>\SOFTDIST\REPOS. 

Type: Optional 

ServiceArea 

Is the new default path for the service directory. The default is 
<drive>\SOFTDIST\SERVICE. 

Type: Optional 

WorkArea 

Is the new default path for the workarea directory. The default is 
<drive>\SOFTDIST\WORK. 

Type: Optional 

InventoryProgram 

Is the new default path for the inventory program. You must specify this keyword 
only if you install the Hardware and Software Discovery Tool component. The 
default is <drive>\SOFTDIST\BIN\FNDINV.EXE. 

Type: Optional 
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LocalDomainAddress 

If you will be connecting to a TME 10 Software Distribution manager on MVS or 
AIX, this is the name of the domain to which this TME 10 Software Distribution 
server and its distribution clients belong. 

Type: Optional. The default is the first eight characters of the SystemName 
keyword. 

LocalT arget Add ress 

The name by which this distribution server is to be known by the MVS or AIX 
TME 10 Software Distribution server and the distribution clients in the LAN. 

Type: Optional. The default is the first eight characters of the SystemName 
keyword. 

Enterprise Connectivity Configuration Keywords (Server Only) 

EnableRemoteCommunication 

Enables communication with NetView DM for MVS or TME 10 Software 
Distribution for AIX. 

The value can be: 

Yes To enable communication with NetView DM for MVS or TME 10 Software 
Distribution for AIX; 

No To disable such communication. 

Type: Optional; the default is No. 

You can define one or more remote server, and for each of them you must 
specify a set of parameters. The set of parameters are platform dependent. The 
keywords that belong to the definition of a server must be grouped by a 
progressive suffix that you put at end of the keyword. 

An example of the keywords you specify in the response file to define an AIX and 
an MVS server follows: 
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Enabl eRemoteCommuni cati on = YES 

; This section defines an MVS host 
DomainAddressG = SPA001 

TargetAddressQ = I9RL008A 

Protocol© = APPC 

LUAliasO = MYALIAS 

ModeNameQ = LU62 

RemoteNetworkldO = SPAO01 

RemoteLUNameG = I9RL0Q8A 

Focal PointG = YES 

; This section defines a TME 10 Software Distribution remote server 

DomainAddressl = MYSRV 

TargetAddressl = MYSRV 

Protocol 1 = TCP/IP 

RemoteHostNamel = myhostname 

Focal Pointl = NO 

Note: Each server defined must be given a unique suffix on each keyword. In 
the example above, the MVS host has the suffix G and the TME 10 Software 
Distribution remote server has the suffix 1. 

DomainAddressx 

Where x is the sequence number of the server being defined. 

If your server is to be connected to a remote software distribution manager, the 
name of the network to which the remote server belongs. If the remote server is 
a NetView DM for MVS system, this name must be equal to the network ID of the 
partner LU in the Personal Communications APPC configuration of this 
workstation. If the remote server is a TME 10 Software Distribution server, this 
is the domain address of the TME 10 Software Distribution server. 

The name can be up to eight characters long. The characters can be letters, 
numbers, or the special characters @, $, and #. An asterisk (*) implies that any 
of the defined domains is considered valid. 

Type: Required for connection to a remote TME 10 Software Distribution server 

TargetAddressx 

Where x is the sequence number of the server being defined. 

The remote server name. If the remote server is a NetView DM for MVS system, 
the target address is the logical unit (LU) name assigned to NetView DM for 
MVS; it must therefore correspond to the name of the partner LU in the Personal 
Communications APPC configuration of the target workstation. 

If the remote server is a TME 10 Software Distribution server, this name is the 
target address of the TME 10 Software Distribution server. 

The name can be up to eight characters long. The characters can be letters, 
numbers, or the special characters @, $, and #. An asterisk (*) implies that any 
of the remote servers is considered valid. 
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Type: Required for connection to a remote TME 10 Software Distribution server 

Protocol* 

Where * is the sequence number of the server being defined. 

The protocol that the remote server and the TME 10 Software Distribution server 
will use to communicate. Valid values are APPC and TCP/IP. APPC requires 
that Personal Communications be installed and configured on the 
TME 10 Software Distribution server. TCP/IP requires that TCP/IP be installed 
and configured on the TME 10 Software Distribution server. 

Type: Required for connection to a remote TME 10 Software Distribution server 

LUAIiasx 

Where * is the sequence number of the server being defined. 

The LU alias name that identifies the software distribution program to Personal 
Communications when an APPC session is established with the NetView DM for 
MVS remote system. 

The local LU alias name that identifies the target workstation, as defined in the 
local Personal Communications APPC configuration. Maximum length is eight 
characters. 

The name is case sensitive. Enter it exactly as in the Personal Communications 
configuration. 

If you do not enter a name here, Personal Communications uses the defined 
local LU name or local CP name in lieu of the local LU alias (if there is a working 
Personal Communications APPC configuration). 

Type: Optional; valid for APPC connection only 

ModeNamex 

Where x is the sequence number of the server being defined. 

The name of the logon mode table entry, in the MVS system, that contains the 
session parameters used for establishing the APPC session between NetView 
DM for MVS and this TME 10 Software Distribution server. Enter the name of 
the mode as defined in the Personal Communications APPC configuration of the 
target workstation. Maximum length is 8 characters. 

If you do not specify a mode here or in Personal Communications, Personal 
Communications uses one of the default IBM-supplied modes. Note, however, 
that to communicate with the MVS remote system, the mode definition must 
contain: 

P LU_M0DE_S ESS 1 0N_L I M I T= 1 

Type: Optional; valid for APPC connection only 

RemoteNetworkldx 

Where x is the sequence number of the server being defined. 

For a NetView DM for MVS remote server, the name of the network to which it 
belongs; for a TME 10 Software Distribution remote server, its host name. 
Maximum length is 8 characters. 
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Type: Required for connection to a remote TME 10 Software Distribution server 
if DomainAddress is *. 

RemoteLUNamex 

Where x is the sequence number of the server being defined. 

The logical unit name of the NetView DM for MVS remote server. Maximum 
length is 8 characters. 

Type: Required for connection to NetView DM for MVS if TargetAddress is *. 

HostNamex 

Where x is the sequence number of the server being defined. 

The host name of the TME 10 Software Distribution server. 

Type: Required for the connection to the remote server. 

FocalPointx 

Where x is the sequence number of the server being defined. 

YES or NO to indicate whether the remote TME 10 Software Distribution server 
is a focal point. Only one server can be configured as a focal point. The default 

is NO. 

Type: Optional 
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Appendix B. Implementing Inventory Discovery 



Inventory discovery is the process that discovers what hardware and software is 
present on a system. You can make use of inventory information when you formulate 
the prerequisites for change control and distribution requests. For instance, you can 
specify that a software object be installed only on workstations that have at least 5MB 
of disk space available. Inventory information can also be used as one of the criteria 
for forming dynamic groups. 

Inventory data is transferred from clients to the server when you do either of the 
following: 

• From the command line interface, submit the nvdm inv command. 

• From the graphical interface, select Inventory from the Selected pull-down menu 
in the Targets window. 

Inventory discovery is not a mandatory part of TME 10 Software Distribution. You can 
configure the hardware present on a local target using the user interfaces. However, 
the inventory discovery process is a way of compiling this information automatically and 
of keeping it up to date without the administrator of your system becoming involved. 

Inventory discovery can be performed on remote targets if the targets involved in the 
operation are connected by the server-to-server (STS) transmission protocol. 



OS/2 and Windows Inventory Discovery Program 

A program that takes advantage of NetFinity inventory services on workstations that run 
OS/2 and Windows clients is provided as an optional component at client installation. It 
is called fndinv, and it uses NetFinity services to create output files at each target. 

The discovered hardware and software data is collected and stored at the target in 
these files: 

fndtkinv Stores discovered installation parameters 

fndswinv Stores discovered software information 

fndhwinv Stores discovered hardware information 

FM apping to the TME 10 Software D istribution Inventory Files” on page 249] describes 
their formats. From these files the data is then transferred to the server's database. 

Before running this inventory discovery program you must: 

1 Make sure a NetFinity Manager workstation is installed in your network. 

At the NetFinity Manager workstation: 

2 Edit the inventory dictionary file named DEFAULT. SID. (You can also begin with a 
different dictionary file, but the final file that TME 10 Software Distribution is to 
use must be named DEFAULT. SID.) From the Dictionary pull-down, select Edit 
to edit the dictionary file. Select, in turn, each product you want to be detected by 
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the TME 10 Software Distribution inventory discovery process. Edit the product 
to fill in two fields: 

NVDM Change Object 

Is the software object name that TME 10 Software Distribution is to 
use to identify this product. 

NVDM Location Token 

Is a symbol for which TME 10 Software Distribution will substitute 
the path in which the product is installed. 

At the distribution server: 

3 Retrieve DEFAULT. SID from the NetFinity Manager workstation. 

4 Send DEFAULT. SID to the targets where you want to perform software and 
hardware inventory. Store it in <product_directory>\bin. 

5 Identify the workstations where you want to run inventory discovery, and add the 
following keyword to their nvdm.cfg file: 

INVENTORY PROGRAM: fndinv 

6 Enter: 

nvdm inv -w target_name 

The program gathers all hardware and software data from the target and stores it 
in the server's catalog. 



Writing an Inventory Discovery Program 

You can choose to buy an inventory discovery program from a third party or to write 
one yourself. 



If you are writing an inventory discovery process, you need only provide the information 
that TME 10 Software Distribution requires. This information is presented to 



TME 10 Software Distribution in text files, the format of which is described in |“Mappinq 



|to the T ME 10 Software Distribution Inventory Files” on page 2491 You do not need to 
provide information about all of the hardware or software present. Even a subset of the 
information can be used by TME 10 Software Distribution. In particular, you can 
choose to provide information about the hardware only or the software only. 



To run the program when the inventory discovery is performed, the program name, with 
its complete path, must be specified in the INVENTORY PROGRAM keyword in the nvdm.cfg 
file. Inventory discovery is performed at each target running the program specified in 
the target's nvdm.cfg file. 
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Mapping to the TME 10 Software Distribution Inventory Files 

Information about discovered software and hardware is presented to TME 10 Software 
Distribution at targets in text files. If you write inventory discovery yourself, you can 
send information directly to these files. If you choose to store the information 
differently, or if you are using a third-party inventory discovery procedure, you must 
produce a process to map your data to the inventory discovery files. 

Installation Parameters Inventory File 

You present information about discovered installation parameters in the installation 
parameters inventory file. This file is stored as <product_directory>\fndtkinv. You need 
root privileges to write to it. 

The first time you run inventory discovery at a target, the information stored in its 
fndtkinv file is registered at the server. Any additional updates to the fndtkinv file are 
registered at the server when the inventory discovery process is run again. 

The file is a text file with a fixed format. Each line defines a single installation 
parameter. You can define up to 1000 installation parameters. Blank lines are 
permitted. Comment lines begin with #. 

Each parameter is presented as a keyword followed by a colon (:) or an equal sign (=). 
For example, the installation parameters inventory file can contain the following lines: 

dirl: c:\mydir 
dir2= c:\mydir 

Software Inventory File 

You present information about discovered software in the software inventory file. This 
file is stored as <product_directory>\fndswinv. and it is created when you run inventory 
discovery. 

A default software inventory process, called fndinv, is installed as part of 

TME 10 Software Distribution under <product_directory>\bin. This is the program that 

is executed when you run inventory discovery and creates the fndswinv file. 

The file is a text file with a fixed format. Blank lines are permitted. Comment lines 
begin with #. You need root privileges to write to it. 

Each product is described by keywords. 

iFigure 159 on page 250| shows a discovered software package. The package contains 
Version 1 .3 of the messages required by a holiday booking application. 
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PRODUCT: 


EUR0T0URS. HOLS. MESSAGES. REF. 0103 


CHANGE FILE TYPE: 


GEN 


DESCRIPTION: 

PRODUCT: 


Message file for Eurotours Holidays Application 


TAG: 


H0LMSG 


REVISION: 


1.3 


ARCHITECTURE: 


OS/2 


VENDOR TAG: 


IBM 


TITLE: 


Message in a bottle 


FILESET: 


TAG: 


Base 


REVISION: 


1.1.2 


TITLE: 


Base feature 


FILESET: 


TAG: 


Message 


REVISION: 


1.2 


TITLE: 


Message feature 



Figure 159. Discovered software package 



Hardware Inventory File 

You present information about discovered hardware in the hardware inventory file. This 
file is stored as <product_directory>\fndhwinv. You need root privileges to write to it. 

The file is a text file with a fixed format. Each line defines a single hardware 
parameter. You can define up to 128 hardware parameters. Blank lines are permitted. 
Comment lines begin with #. 

Each parameter is presented as a keyword followed by a colon (:) followed by a 
number. The definition of the keyword and the meaning of the numeric value depends 
on the construction of the software object that references the hardware prerequisites. 

For example, the hardware configuration file might contain the following line to indicate 
that the target has a 600 MB hard disk. 

FixedDisk.capacityMb: 600 

TME 10 Software Distribution, Version 3.1.5 for OS/2 uses the following default 
keywords to identify discovered hardware devices. If you use another tool, be sure to 
map the hardware keywords generated to these standard keywords: 
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Inventory.dateAcquired 


Equipment.machineModel 


PWS.memorySizeMb 


PWS.parallelPorts 


PWS.planarFRUNumber/ 


PWS.busType/ 


PWS.biosLevelDate/ 


PWST ype. processor/ 


PWS.coProcessor/ 


PWS. language/ 


Display.adapterType/ 


Display.type/ 


Display.hozResolution/ 


Display.verResolution/ 


Keyboards 


Keyboard.adapter/ 


Keyboard. subCountryCode/ 


Keyboard.codePage/ 


Printer.driver/ 


Plotters 


Mouse.type/ 


Mouse. buttons/ 


LogicalDisk.fileSystem/ 


LogicalDisk.availCapacityMb/ 


DisketteDrive.type/ 


DisketteDrive. adapter/ 


DAS D . adapte rT ype/ 


DASD.adapterAttributes/ 


CDROM/ 


CDROM. capacityMb/ 


Tape/ 


Tape.typeModel/ 


Ethernet Adapte r. add ress/ 


TRAdapters 


N etwo rk 1 nte rf aces 


N etwo rkl nte rf ace/ 


IP_Network.ip_subnet_mask/ 


IP_Network.ip_network_name/ 


MagnetoOpticalDrive.capacityMb/ 


ProtocolConverter/ 


SerialDevice/ 


SerialPort/ 


ParallelPort/ 


SCSIAdapter/ 


TTY.speed/ 


PTY/ 


LVM/ 


LFT/ 


Driver/ 


Drawer/ 


TTYs 


PTYs 


LVMs 


LFTs 


ParallelPorts 


SerialPorts 


SCSIAdapters 


OpticalAdapters 


OtherDrivers 


OtherDevices 



OperatingSystem 


OperatingSystem.version 


PWS.serialPorts 


PWS. planar/ 


PWS.biosType/ 


PWS.biosRevisionLevel/ 


PWST ype. processorSpeed/ 


PWS.coProcessors 


PWS.cacheSizeKb 


Display.adapters 


Display.memory/ 


Display.colors/ 


Display.hozSize/ 


Display.verSize/ 


Keyboard, type/ 


Keyboard.countryCode/ 


Printers 


Printer/ 


Plotter/ 


Mouses 


Log ical Disk, d riveLette r / 


LogicalDisk.volumeLabel/ 


DisketteDrives 


DisketteDrive/ 


FixedDisks 


FixedDisk.capacityMb/ 


DASD.adapterlOType/ 


CDROMs 


CDROM.typeModel/ 


Tapes 


EthernetAdapters 


EthernetAdapter/ 


TR Adapter/ 


TRAdapter.address/ 


IPJnterface/ 


IP_Network.ip_address/ 


AdapterBoards/ 


MagnetoOpticalDrive/ 


Repeater/ 


Router/ 


Tablet.adapter/ 


Tablet.type/ 


Optical Adapter/ 


TTY/ 


HFT / 


DLC/ 


ROM/ 


Adapter/ 


OtherDevice/ 


Tablets 


HFTs 


DCLs 


ROMs 


MultiSubchannels 


MultiprotocolPorts 


Protocol Drivers 


Drawers 


OtherAdapters 



Defining a Filter for Hardware Keywords 

You do not have to store all the hardware keywords discovered for targets in the server 
database. You can define a subset of those you are interested in, and when the 
inventory data is sent to the server they will be filtered out from among those 
discovered. You may also specify keyw ords that are not found in the default list in 
[“Hardware Inventory File” on page 250l 

To record only selected hardware keywords in the catalog, specify them in the text file 
called hwfi 1 ter, which is stored in the <product_directory>\db directory on the server. 
Each line in the file can contain only one keyword which contains no blanks. The file 
can include comment lines that are preceded by the number sign (#). 

Each server in a hierarchy can have a different filter file (see |“Routing Inventory! 
[Information to Upstream Servers” on page 252| . Downstream servers send the 
complete file of discovered hardware to servers above it in the hierarchy; any filtering is 
performed at each server the inventory file is routed to. 



Running Inventory Discovery 

You do not normally need to run inventory discovery more often than every time you 
start your target. It is probably best to include inventory discovery as part of your 
startup sequence. 

If you add software packages without using TME 10 Software Distribution and without 
restarting, run the inventory discovery command so that the new software is discovered 
and inserted in the database. 
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Routing Inventory Information to Upstream Servers 



Notify TME 10 Software Distribution of the discovered hardware and software by 
performing the inventory discovery program on your target. The inventory command 
sends the data from your target to the server, where it is added to the central 
TME 10 Software Distribution database. You must run this command to register your 
inventory even if your target is the server itself. 

Run the inventory discovery program whenever you change the contents of the 
inventory files. You can run the program as part of your startup sequence or from a 
script or directly from the user interfaces. You need Modify Configuration authorization 
to issue the inventory command. 

Hardware inventory information is copied to the target hardware file. Software inventory 
data results in the creation of a catalog entry and status record with the status of 
discovered, which means that the software is installed but that it was not installed by 
TME 10 Software Distribution. Discovered software is active and not removable. 

The discovered hardware inventory is completely refreshed each time this command is 
run. The discovered software inventory is cumulative. That is, you can only add 
entries using this command. To delete a discovered software package from the 
inventory, you must remove it from the catalog. 

The inventory command is scheduled automatically when you add a new target using 
either the graphical interface or the nvdm addtg command from the command line 
interface. 



Routing Inventory Information to Upstream Servers 

The inventory data discovered for a target can be stored and updated at all servers 
connected in an upstream hierarchy to the target's local server. Information will be 
routed and stored at all servers that have the following keyword set to YES in their 
base configuration file (nvdm.cfg): 

AUTOMATIC TARGET INFO UPDATE YES 

The base configuration file is de scribed in the [Cha pter 10, “Editing the Basel 
Configuration File” on page 73 
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Appendix C. Replacing the Quiesce Check 



This appendix describes how you can replace the quiesce check on any target. 



What the Quiesce Check Does 

Some change control operations check that the computer is not in use before the 
operations actually begin. This check is called the quiesce check, and, by default, 
checks that no users are logged on to the system. The results of the check are then 
returned to TME 10 Software Distribution. However, there may be occasions where 
the default quiesce check is not appropriate. For example, if users usually do not log 
off at the end of a work day, then the quiesce check always fails. A check that no 
processing power was being used is a more appropriate check. 

Also, checking that no users are logged on does not prove that no processes are 
running that might interfere with the change control operation. For example, you may 
be attempting to uninstall a word processor on a computer while a background task 
(started by a user who is now logged off) is performing a batch of mail merges. 

TME 10 Software Distribution enables you to address these kinds of scenarios by 
allowing the quiesce check to be replaced by a more appropriate check. Different 
targets on a network can each have different quiesce checks. This appendix describes 
how to replace the default TME 10 Software Distribution quiesce check with a check 
more suitable to the needs of your environment. 



Implementing Quiesce Checks 

The quiesce check on a target is performed by a script. This script is named quiesced 
and is stored in the directory with the other TME 10 Software Distribution scripts: 

<product_directory>script 

To replace the quiesce check, all you need to do is replace the script. The new script 
should: 

• Not include any parameters 

• Return 0 if the target is quiesced 

• Return 2 if the target is not quiesced. 



Example of a Check Script Used for Quiesce Checks 

Fi gure 160 on page 254| shows an example of a quiesce script that performs the same 
function as the default script supplied with TME 10 Software Distribution, returning 0 if 
no users are on the system and returning 2 otherwise. 
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Example of a Check Script Used for Quiesce Checks 



# 






# 


Checks if the Target computer is quiesced or not depending 


# 


on the number of 


logged-in users. The Target is deemed to 


# 

# 


be quiesced if no 


users are logged-in. 


# 

# 

# 


Returns : 




ff 

# 


0 - the Target is 


quiesced 


# 

# 


2 - the Target is 


not quiesced 


numusers= who | wc -1 


# Calculate the number of logged-in users 

# by listing the users and counting the 

# number of lines. 


if 


test Jnumusers = 0 


then # If no users are logged in 




exit 0 


# Return 0, meaning 'quiesced' 


el se 


# Otherwise 


fi 


exit 2 


# Return 2, meaning 'not quiesced' 



Figure 160. Example of a check script used for quiesce checks 
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Appendix D. Writing Change Control Scripts 



This appendix provides guidelines to help you write a change control script. It 
describes the parameters for scripts and how you can use them. 

You can call change control scripts before and after most change control operations. 
The names of the scripts are contained within the software object. If no name is 
specified, no script is executed. 

In addition to being named in the software object, scripts must be included as files to 
be installed unless they already exist on the target. The specification must refer to the 
complete path name where the script will be installed at the target. 

Each script has a different set of parameters. These parameters, detailed in the next 
section of this appendix, are passed to it by the change control driver when it is 
executed. 

A script produces a return code of 0 if it is successful. Any other value signifies that an 
error has occurred. If an error occurs, the entire change control request that is 
scheduled fails. 

When scripts are being executed, any output generated to standard output is 
automatically redirected to a file called request. out. This file is stored in the work 
area. It is deleted before each new request. 

The following sections describe the parameters that the driver passes to change control 
scripts when they are executed. 



Creating Pre-Install and Post-Install Scripts 

Use the following parameters for the pre-install and post-install scripts: 

Install to Active Area 

Whether the software object is being installed to the active or service area. 
Valid entries are: 

YES The installation is to the active area. 

NO The installation is to the service area. 

Service Subdirectory 

Name of the service subdirectory. This is NUL if the installation is to the 
active area. 



Removable 

Whether the installation is removable. Valid entries are: 

YES The installation is removable. 

NO The installation is not removable. 

DESIRED Try to make the installation removable. If it cannot be done, 
do not fail the installation. 
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Creating Pre-Accept and Post-Accept Scripts 



Backup Subdirectory 

Name of the backup subdirectory. This entry is NUL if the installation is not 
removable. 



Creating Pre-Remove and Post-Remove Scripts 

Use the following parameters for the pre-remove and post-remove scripts: 

Request type 

The type of request that gave rise to this event. Possible values are 
REMOVE, or INSTALL if the current removal is taking place because an install 
request failed to complete. 

Action 

The action to be taken by the remove may take one of these three values: 

DELETE_SERVICE The installation should be deleted from the service 
subdirectory 

RESTORE_SERVICE The removal should be performed in the service area 
RESTORE_ACTIVE The removal should be performed in the active area. 

Backup Subdirectory 

The name of the backup subdirectory. 

Service Subdirectory 

The name of the service subdirectory. This is NUL if the action was 
RESTORE_ACTIVE. 



Creating Pre-Accept and Post-Accept Scripts 

Use the following parameters for the pre-accept and post-accept scripts: 

Request type 

This specifies the type of request that caused this event. Possible values 
are ACCEPT, or INSTALL if the current accept is taking place because of an 
install request with automatic acceptance specified. 

Backup Subdirectory 

The name of the backup subdirectory. 

Service Subdirectory 

The name of the service subdirectory. This is NUL if there is no service 
subdirectory. 
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Understanding Script Exit Codes 



Creating Pre-Uninstall and Post-Uninstall Scripts 

Use the following parameters for the pre-uninstall and post-uninstall scripts: 

Action 

The action to be taken by the accept may take one of four values: 

D E LET E_S ERV ICE The installation should be deleted from the service 

subdirectory 

RESTORE_SERVICE The uninstall operation should be performed in the 
service area 



RESTORE_ACTIVE The uninstall operation should be performed in the 
active area 

DELSERV_RESTACT The change file should be deleted from the service 

area and the software object should then be uninstalled 
from the active area. 



Backup Subdirectory 

The name of the backup subdirectory. This is NUL if the software object 
was not removable. 

Service Subdirectory 

The name of the service subdirectory. This is NUL if the action is 
RESTORE_ACTIVE. 



Creating Pre-Activate Scripts 

Use the following parameters for the pre-activate script: 

Request type 

This specifies the type of request that is being activated. Possible values 
are INSTALL, REMOVE, and UNINSTALL. 

Service Subdirectory 

The name of the service subdirectory. 



Understanding Script Exit Codes 

All pre- and post-requests, pre- and post-scripts, and procedures invoked by 
TME 10 Software Distribution return the following exit codes: 

0 The script was run successfully. 

1 This exit code is reserved for use by the system. It indicates that the shell 
returned an error. 

2-50 The script returned an error. 

51-100 The script was run successfully. 

All other codes 

This exit code is reserved for use by the system. It indicates that an error 
occurred. 
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General-Use Programming Interface 



Before reading this chapter you should have an understanding of C language 
programming, and be able to compile and link applications under the operating system 
TME 10 Software Distribution is running under. 



Overview 



In certain areas of TME 10 Software Distribution, user exits are included. User exits 
are places in the code where you can add your own functions. 

The C language source code for these empty functional areas is provided with both the 
TME 10 Software Distribution server and client. You can edit the code to make it 
perform the function that you require, and then compile it into a shared library from 
which it can be called by the program. 

This appendix describes each user exit function and explains how to compile and link 
any changes that you make. It provides: 

• A description of the files provided to enable you to write and compile user exit 
code. 

• A description of the user exits, detailing when they are called. 

• A description of the compilation methods to use to compile and link user exit code. 



Files Provided 

The following files are provided on both server and client, in the directory SRC on the 
CD-ROM, to assist you in writing user exit routines. 

• Source files containing the empty user exit functions: fndcx.c, fndcxcm.c, 
fndcxmo.c, fndssext.c, and fndsx.c 

• Make files, used when compiling and linking the user exit code: fndcx.mak, 
fndsx.mak and fndss.mak 

Note that these files are provided on the CD-ROM and are not installed on your 
workstation as part of product installation. 



User Exits 



This section describes each of the user exit functions that TME 10 Software 
Distribution supports. The next section describes the mechanics of compiling and 
linking any changes that you make. 
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Header Files 

Some of the user exits receive as parameters structures that are used in the 
TME 10 Software Distribution program. To enable you to use these structures, the 
necessary header files are supplied. These files contain comments describing the 
meanings of the fields in the structures. 

Because these files are the header files used for the actual product, they contain the 
definitions of structures that you do not require. Ignore these extra structures. 

The structures and fields of interest to you are mentioned in the description for each of 
the user exits. Do not change any fields unless you are advised that you can do so. 

IBM will not support problems due to use of unauthorized fields in user exits. 

Generating Local File Names (ss_user_loc_name) 

This user exit is used only on the server. It is called when TME 10 Software 
Distribution needs to store a file, but does not have a local name to use. This event 
occurs when a distribution is received or a software object is built and cataloged without 
being given a local name. 

TME 10 Software Distribution generates a default local name by concatenating the 
label with the token $ (REPOSITORY). The default local name is then passed to this user 
exit, that can modify the name. Control is then returned to TME 10 Software 
Distribution, which uses the updated name to store the local file. 

For software objects and plans transmitted over server-to-server connections, however, 
the user exits is always called before cataloging the file to allow the user to change the 
local file name used. For the other types of files, the user exit is called to allow the 
user to change the local file name corresponding to the file system ID specified. 

The name is passed as a pointer to a character array. This file contains the local file 
name as a null terminated string in a 256-byte buffer. If you replace it with a longer 
string, make sure that you do not exceed the 256-byte limit. 

This user exit is located in the source file fndssext.c, and is called ss_user_loc_name. 

Notifying Requests (sx_server_request) 

This user exit is used only on the server. It is called after a change control or 
distribution request has been submitted, and is passed a data structure containing the 
request data. 

This user exit can be used, for example, to record that a request is scheduled for a 
target and then correlate the request with the next user exit (sx_server_report) when 
the current request is completed. 

This user exit is supplied with a pointer to an RR_INF0 (defined in fndcx.h) and to a 
CX_USER_RESPONSE structure (defined in fndcx.h). 
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The R R_ INFO structure contains the request to be performed in the type_data field. The 
CX_USER_RESPONSE structure is currently not used. In the future it may be possible for 
the user exit to return a value to this structure to specify that the request should be 
postponed or canceled. 

Notifying Completion (sx_server_report) 

This user exit is used only on the server. It is called when TME 10 Software 
Distribution receives a report from a target, immediately before the report is deleted, 
and after the update of the status in the database. A data structure containing the 
report is passed to it. 

This user exit is supplied with a pointer to an RR_INF0 (defined in fndcx.h). The 
R R_ INFO structure contains the request to be performed in the type_data field. 

Modifying Local File Names (cx_daca_filename) 

This user exit is present on all TME 10 Software Distribution workstations. It is called 
immediately before: 

• Deleting a local file 

• Storing a local file 

• Sending a local file (after a send request) 

• Sending a local file (in answer to a retrieve request) 

The user exit is provided with the global and local names of the file. The local name 
has already undergone token substitution at the time that it is called. You can change 
the local file name, but not the label. 

One use of user exit might be to reroute local files that should be stored in one 
directory to another directory, or to perform a more sophisticated form of token 
substitution than that provided. 

The parameters to the user exit are the label held in a structure that is defined in 
fndhdr.h, and the local name stored as a null terminated string in a 256-byte character 
array. If you replace the local name with a longer string, make sure that you do not 
exceed the 256-byte limit. 

The user exit is located in the source file fndcx.c and is called cx_daca_filename. 

Previewing and Modifying Reports (cx_daca_report) 

This user exit is present on all TME 10 Software Distribution workstations. It is called 
immediately before the target sends a report about change control or distribution activity 
back to the server. A data structure containing the report is passed to it. 

You can use this user exit to keep local copies of reports that are sent to the server, so 
that the user of the target can see what change control and distribution events have 
taken place. 

The user exit is supplied with a pointer to an RR_INF0 structure that contains the report 
that will be sent to the server. This structure is defined in fndcx.h. 
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The RR_INFO structure contains the report that will be sent to the server in the 
type_data field. The type field contains the type of report held in the type_data field. 

The user exit is located in the source file fndcx.c, and is called cx_daca_report. 

Previewing Requests (cx_daca_request) 

This user exit is present on all TME 10 Software Distribution workstations. It is called 
immediately before a target carries out a change control or distribution request, and 
passed a data structure containing a copy of the request. 

You can use this user exit to provide a warning to all users of the system that a change 
control or distribution operation is about to take place. 

The user exit is supplied with a pointer to an RR_INF0 structure (defined in fndcx.h) 
and a CX_USER_RESPONSE structure (defined in fndcx.h). 

The RR_INF0 structure contains the request that is about to be performed in the 
type_data field. 

The CX_USER_RESPONSE structure is currently not used. In the future it may be possible 
for the user exit to return a value in this structure to specify that the request should be 
postponed or canceled. 

The user exit is located in the source file fndcx.c and is called cx_daca_request. 

Exporting Directories (sx_export_dir) 

This function is called by the server to export a list of directories to a given target. It is 
called before enqueuing a request to the target. 

The function is defined as follows: 



DC USHORT sx export dir (REMOTE DIR 


*remote_di r. 


TARGET INFO 


*target_i nfo. 


DC LONG 


*errcode, 


DC USHORT 


prot) ; 



The REM0TE_DIR structure contains the following fields: 

• Exported directory 

• Mounted file system 

• Mount options 

• Export options 

The values returned from the function are: 

0 Directory successfully exported for the target. An informational message is 
logged. 
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4 Directory already exported for the target. An informational message is logged. 

8 An error was encountered exporting the directory for the target. An error 
message is logged with the operating system error-code return in the output 
parameter errcode. 

This user exit is located in the source file fndsx.c. 




If this function is to be executed using the LAN Server services, the fields of 
the build profile concerning the build of a dynamic software object must be set as 
follows: 



SERVER NAME: <LAN Server Name> <Domain name> 

EXPORTED DIRECTORY: <di rectory to be exported> 

MOUNTED FILE SYSTEM: <drive used by the client to attach the server> 

MOUNT OPTIONS: <alias name of the exported directory> 



At the client, the mount with LAN Requester results in a logon with userid equal to the 
TME 10 Software Distribution workstation name, followed by a net use command. 

LAN Server allows only one user to be logged on at a time. If a user is already logged 
on at the time of the mount, any disks already attached by the previous logon are 
detached by the new one. 



Removing Exports (sx_unexport_dir) 

This function is called by the server to remove a list of directories for a given list of 
targets. It is called when the request is completed. 

The function is defined as follows: 



DC USHORT sx unexport dir (REMOTE DIR 


*remote_di r. 


TARGET INFO 


*target_i nfo. 


DC LONG 


*errcode, 


DC USHORT 


prot); 



The values returned from the function are: 

0 Directory successfully unexported for the target. An informational message is 
logged. 

8 An error was encountered unexporting the directory for the target. An error 
message is logged with the operating system error-code return in the output 
parameter errcode. 

This user exit is located in the source file fndsx.c. 



Appendix E. Writing User Exits 263 





Writing User Exits 




If this function is to be executed using the LAN Server services, the fields of 
the build profile concerning the build of a dynamic software object must be set as 
follows: 



SERVER NAME: <LAN Server Name> <Domain name> 

EXPORTED DIRECTORY: <di rectory to be exported> 

MOUNTED FILE SYSTEM: <drive used by the client to attach the server> 

MOUNT OPTIONS: <alias name of the exported directory> 



At the client, the mount with LAN Requester results in a logon with userid equal to the 
TME 10 Software Distribution workstation name, followed by a net use command. 

LAN Server allows only one user to be logged on at a time. If a user is already logged 
on at the time of the mount, any disks already attached by the previous logon are 
detached by the new one. 



Mounting File Systems (cx_mount_fs) 

This user exit is called by the agent to mount a list of file systems. It is called before 
executing the request. 

The function is defined as follows: 



DC USHORT cx mount fs 



(REMOTE_DIR 
DC_V0ID 
DC USHORT 



*remote_di r, 
**user_data, 
prot); 



The values returned from the function are: 

0 File system successfully mounted. An informational message is logged. 

4 File system already mounted. An error message is logged. 

8 An error was encountered when mounting the file system. An error message is 
logged with the operating system error code return in the output parameter 
errcode. 

This user exit is located in the source file fndcxmo.c. 




If this function is to be executed using the LAN Server services, the fields of 
the build profile concerning the build of a dynamic software object must be set as 
follows: 



SERVER NAME: 

EXPORTED DIRECTORY: 
MOUNTED FILE SYSTEM: 
MOUNT OPTIONS: 



<LAN Server Name> <Domain name> 

<di rectory to be exported> 

<drive used by the client to attach the server> 
<alias name of the exported directory> 
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At the client, the mount with LAN Requester results in a logon with userid equal to the 
TME 10 Software Distribution workstation name, followed by a net use command. 

LAN Server allows only one user to be logged on at a time. If a user is already logged 
on at the time of the mount, any disks already attached by the previous logon are 
detached by the new one. 

Unmounting File Systems (cx_unmount_fs) 

This user exit is called by the agent to unmount a list of file systems. It is called when 
the request is completed. 

The function is defined as follows: 



DC USHORT cx unmount fs 



(REMOTE_DIR 
DCJ/OID 
DC USHORT 



*remote_di r, 
**user_data, 
prot) ; 



The values returned from the function are: 

0 File system successfully unmounted. An informational message is logged. 

8 An error was encountered while unmounting the file system. An error message is 
logged with the operating system error-code return in the output parameter 
errcode. 

This user exit is located in the source file fndcxmo.c. 




If this function is to be executed using the LAN Server services, the fields of 



the build profile concerning the build of a dynamic software object must be set as 
follows: 



SERVER NAME: <LAN Server Name> <Domain name> 

EXPORTED DIRECTORY: <di rectory to be exported> 

MOUNTED FILE SYSTEM: <drive used by the client to attach the server> 

MOUNT OPTIONS: <alias name of the exported directory> 



At the client, the mount with LAN Requester results in a logon with userid equal to the 
TME 10 Software Distribution workstation name, followed by a net use command. 

LAN Server allows only one user to be logged on at a time. If a user is already logged 
on at the time of the mount, any disks already attached by the previous logon are 
detached by the new one. 



Adding Target Parameters (sx_usrexit_trgcfg) 

This user exit is called when a new target is defined. It is used to add any missing 
(optional) parameters to the target definition. The required fields must already be 
specified. 
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The function is defined as follows: 



DC SHORT sx_usrexi t_trgcfg (const DC USHORT action 




const USRX_TARGET CONFIG *in_trg_config, 
USRX_TARGET_CONFIG *out_trg_config) ; 


^•k-k-k-k'k-k-k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-kick-k-k-k-k-k-k-k-kick-k-k-kick-k-k-k-k-k-k-k-k-k-kick 


Description: 




This routine is called when a target configuration record is 


added or updated. 




A user code can be specified to set the default value of a 


target configuration 


record. 


The fields that the product considers are: 


description 


descriptive information 


target_os 


target operating system 


password 


target password 


lan addr 


burned-in LAN address 


cust 


customer name 


contact 


contact name 


contact phone 


contact phone number 


manager 


owning manager's name 


manager_addr 


owning manager's address 


num_hw_parm 


number of hardware parameters 


hw_parm 


hardware parameter array 


num inst_parm 


number of installation parameters 


inst parm 


installation parameter array 


Parameters: 




acti on 




ADD CFG or UPD_CFG depending on command being executed 


in_trg config 




input structure of 


target configuration record 


out trg_config 




output structure of target configuration record in which 
user-exit default values can be specified 


Returns : 




0 completed successfully 


■k-k‘k-k-k-k-k-k‘k-k-k‘k-k-k‘k-k-k‘k-k-k , k-k-k‘k-k-k‘k-k-k‘k-k-k‘k-k-k‘k-k-k-k-k-k-kick‘k-kick-k-k‘k-k-k-k-k-k‘k-k-k‘k-k-k‘k-k-k‘k-kick-ki<^ 



This user exit is located in the source file fndsx.c. 
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Adding User Parameters (sx_usrexit_usrcfg) 

This user-exit is called when a new user is defined in order to add any missing 
(optional) fields. The mandatory fields have to be already specified. 

The function is defined as follows: 



DC_SH0RT sx_usrexit_usrcfg (const DCJJSHORT action 

const USRX_USER_DEF *in_usr_def, 
USRX_USER_DEF *out_usr_def ) ; 

/******************************************************************** 

Description: 

This routine is called when a user configuration record is 
added or updated. 

A user code can be specified to set the default value of a 
user configuration record. 

The fields that the product considers are: 

description : descriptive information 

Parameters: 
acti on 

ADD_CFG or UPD_CFG depending on command being executed 
i n_usr_def 

input structure of user configuration record 
out_usr_def 

output structure of user configuration record in which 
user-exit default values can be specified 

Returns: 

0 completed successfully 

********************************************************************/ 



This user exit is located in the source file fndsx.c. 
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Reporting Request Completion (sx_server_report) 

This user exit is called when a report is returned to the server immediately after the 
change control status has been updated. 

The function is defined as follows: 



DC_V0ID sx_server_report ( REP0RT_I N FO *info); 

/-k-k-k^k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^k-k-k-k-k-k-k-k-k-k-k'k^k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

Description: 

This routine receives the REP0RT_INF0 structure immediately after 
a report has been received by the server and saved in the DB. 

Parameters : 
entry 

pointer to a REP0RT_INF0 structure. 

Returns : 
none 

^k-k-k-k^k-k-k-k-k-k-k-k-k-k-k'k^k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^k-k-k-k-k-k-k'k^k-k-k-k^k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^k^ 



This user exit is located in the source file fndsx.c. 

Reporting Fileset Statuses and Products (cx_vercm) 

This function is called by a TME 10 Software Distribution agent when it has to verify 
the status of filesets contained in a software object. It is run at a workstation where an 
agent product is running, and expresses the status for filesets as a TME 10 Software 
Distribution change management status. 

For each fileset in the software object, the agent calls the cx_vercm user exit and 
creates a report in file fndswcms. If the status of a fileset does not coincide with the 
status of the software object, the status reported by cx_vercm is In error. 

This user exit is located in the source file fndcxcm.c. It has the following format: 



DC_SH0RT cx_vercm (DC_CHAR 


*cf_type, 


DC EXT PRODUCT *product. 


DC EXT FILESET *fileset. 


DC_CHAR 


*mask) ; 
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Product Information 

Information related to products is also provided as input to this user exit. The same 
information is reported in the fndswcms file. It is supplied using the following format: 



typedef struct 


dc ext product (DC CHAR tag [MAX TAG LEM]; 


DC CHAR 


revision [MAX REVISION LEN] ; 


DC CHAR 


archi tecture[MAX ARCHITECTURE LEN]; 


DC CHAR 


vendor tag]MAX VENDOR TAG LEN [; 


DC CHAR 


title [MAX PF TITLE LEN] ; 

) DC EXT PRODUCT; 



Status Exchange Area 

The area in the user exit used to exchange information about the status of a file has 
the following format. The agent provides the change management status of the 
software object to the procedure using the status field. The cx_vercm function 
determines the status of the file at the workstation and updates the status field. 



typedef struct dc ext 


fileset (DC CHAR tag [MAX TAG LEN]; 


DC CHAR 


revision [MAX REVISION LEN]; 


DC CHAR 


title [MAX_PF_TITLE_LEN] ; 


DC CHAR 


status; 


DC USHORT 


fseterror; 




) DC_EXT_FILESET ; 







If the fseterror field contains the value FS_NOT_DISCOVERED, then cx_vercm reports the 
Not discovered status in the fndswcms file. 

TME 10 Software Distribution Statuses 

A status is represented by one byte, where: 

• The four least significant bytes represent a change management status. 

• The four most significant bytes represent a specific TME 10 Software Distribution 
status. 

TME 10 Software Distribution statuses can be one of the following: 

• Available 

• Installed, removable, active 

• Installed, not removable, active 

• Installed, removable, inactive 

• Installed, not removable, inactive 

• Scheduled 

• In error 

• Removed, inactive 

• Uninstalled, inactive 
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• Backlevel 

• Discovered 

• Distributed 

• Distribution pending 

• Authorized at target 

• Authorized at server 

Setting Secure Keys (cx_set_secure_key) 

This user exit is included in the TME 10 Software Distribution base package. It can be 
called when software objects are built and the secure package attribute is set (see 
^Defining Data Security” on page 42j . 

The function calculates and associates a secure key with the software object. The user 
exit is defined as follows. 



extern DC_V0I D cx_set_secure_key ( DC_UL0NG *crc_vector, 

DC_USH0RT number_of_crcs, 

DC_V0ID *secure_key, 

DC_USH0RT secure_key_len) ; 

/-k-k-k^k-k-k'k^k-k-k-k^k-k-k'k^k-k-k-k^k-k-k'k^k-k-k^k^k-k-k'k^k-k-k'k^k-k-k'k^k-k-k-k^k-k-k-k^k-k-k'k^k-k-k'k^k-k-k-k^k-k-k'k^k-k-k-k'k 



Description: 

This function is called by Software Distribution user interfaces 
to calculate, using a user-defined algorithm, the secure key 
to associate with a software object. 



Parameters : 

crc_vector: Pointer to the array containing the CRCs 

associated with all the objects in the 
software object (the CRC is 0 for directories and 
for objects to be deleted). 

number of crcs: Number of elements in the vector. 



secure_key: Buffer containing the calculated secure key 

to be checked at installation time 
(to be returned). Software Distribution 
assumes that if all the bytes are equal to 
\0, the buffer is empty and no secure 
key will be associated with the 
software object. This is the default. 

secure_key_len: Length of the secure key (equal to 32 bytes) 

Return Codes: None 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk/ 
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Checking Secure Keys (cx_check_secure_key) 

This user exit is included in the TME 10 Software Distribution client package. It 
checks the secure key associated with the software object using the 
cx _ se t_ se cur e _key user exit to make sure that the file has not been manipulated. It 
can be used to: 

• Install the software object only if it contains a secure key. 

• Install the software object only if it contains a secure key, and information in the 
secure key semantics identifies the target where the software object was built (for 
example, if the first three characters of the key are 111). 

The user exit is defined as follows. 



extern DC_V0ID cx_check_secure_key ( DC_V0ID *secure_key, 

DC_USH0RT secure_key_len, 
DCJJSHORT *acti on) ; 

^-k-k-k-k-k-krk-k-k-k^k-k-k-k^k-k-k-k-k-k-k-krk-k-k-k^k-k-k-k^k-k-k-k^k-k-k-k^k-k-k-k^k-k-k-k-k-k-k-k-k^k-k-k-k^k-k-k-k^k-k-k-k-k-k-k-k^k 

Descri pti on : 

This function is called by Software Distribution 
when performing an installation to check the secure key 
set in the software object by the cx_set_secure_key . 



Parameters : 

secure_key: Buffer containing the secure key to be check. 

secure_key_len: Length of the secure key (32 bytes), 
action: Possible values are: 

- CMJNSTALLABEE 

This is the default. If this value is 
returned, the agent proceeds with 
the installation. 

- CM_N0_I INSTALLABLE 

If this value is returned, the agent 
halts the installation and reports 
a failure. 

Returns: None 

-k-k-k'k-k-k-krk-k-k-k^k-k-k-k'k-k-k-k^k-k-k'k^k-k-k-k-k-k-k-k'k-k-k-k^k-k-k-k^k-k-k-k-k-k-k-k-k^k-k-k-k^k-k-k-k-k-k-k-k^k-k-k-k'k-k-k-k/ 



Checking CRC Numbers (cx_check_crcs) 

This user exit is included in the TME 10 Software Distribution client package. It 
recalculates the secure key associated with the software object using the 
cx_ se t_ se cure_key user exit to make sure that it is the same. If it is not, the software 
object is not installed. 
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The user exit is defined as follows. 



extern DC_V0ID cx_check_crcs ( DC_UL0NG *crc_vector, 

DC_USH0RT number_of_crcs , 

DC_V0ID *secure_key, 

DC_USH0RT secure_key_l en, 

DC_USH0RT *action) ; 

/-k-k-k^k-k-k-k-k-k-k-k^k-k-k-k-k-k-k-k^k-k-k-k^k-k-k-k^k-k-k-k-k-k-k-k^k-k-k'k^k-k-k-k-k-k-k-k-k-k-k-k^k-k-k'k-k-k-k-k^k-k-k-k-k-k-k-k'k 



Description: 

This function is called by Software Distribution Client 
when performing an installation to recalculate the secure key 
set in the software object and compare it with the key set 
by the cx_set_secure_key when the software object was prepared. 



Parameters : 

crc_vector: Pointer to the array containing the CRCs 

associated with all the objects in the 
software object (the CRC is 0 for directories 
and for objects to be deleted). 

number of crcs: Number of elements in the vector. 



secure_key: 
secure_key_l en: 



Buffer containing the calculated secure key 
to be verified during the installation. 
Length of the secure key (32 bytes). 



action: 



Possible values are: 



- CMJNSTALLABLE 

This is the default. Proceed with the 
installation. 



- CM_NO_INSTALLABLE 

If this value is returned, it means that 
the comparison between the secure key 
calculated when the software object was 
prepared and the secure key calculated 
during installation was not successful. 

In this case Software Distribution Client 
ends the installation and reports 
a failure. 



Returns: None 
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Compilation Method 

After compilation, the user exits are contained in three DLLs: FNDCX.DLL, 

FNDSX.DLL, and FNDSS.DLL. Three make files, FNDCX.MAK, FNDSX.MAK, and 
FNDSS.MAK, are provided for use in building the DLLs using the IBM C/C++ compiler. 

The syntax of the command to obtain the DLL is: 
nmake <makefi 1 ename> 

Since the three DLLs obtained will reference the dynamic link library DDE4MBS.DLL 
provided by C++, after having built the three DLLs, you need to rename this DLL to 
FND4MBS.DLL, and also change the reference to this name in the FNDXXX.DLLs. 

You can do that with the utility DLLRNAME.EXE provided with IBM C/C++, as follows: 

1 Copy the DDE4MBS.DLL to a working directory. 

2 In this directory, enter the command: 

DLLRNAME DDE4MBS.DLL DDE4MBS=FND4MBS 

You will obtain a DLL named FND4MBS.DLL. Copy it into the subdirectory B 1 BIN 
of the product directory. 

3 For each of the three DLLs you built, change the name by entering the command: 
DLLRNAME FNDXXX.DLL DDE4MBS=FND4MBS 

I End of General-Use Programming Interface I 
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Before you can use CID software preparation to prepare a software product for 
distribution, you must have an application definition file (ADF) for the product. 
CID-enabled products can also provide ADFs on their distribution media. You can also 
create your own ADFs. 

If you decide to create an ADF, consider that you can choose from two approaches for 
providing responses during a CID installation. An ADF can specify that an existing 
response file is to be used, or it can specify that TME 10 Software Distribution is to 
generate the response file from information provided during CID software preparation. 



Using an Existing Response File 

If you choose this approach, the configuration of the product at the distribution client is 
done by using an external response file. Be sure that the response file is stored at the 
code server in the directory: 

<dri ve> : \<C I D_d i rectory_path>\RSP\<product_name> 



In Chapter 17, “Setting Up for CID Preparation” on page 21~5j the directory is: 



C:\CID\RSP\<product_name>\ 



Generating the Response File 

If you choose this approach, the product at the distribution client is configured during 
the CID software preparation task. TME 10 Software Distribution generates the 
response file based on the configuration values supplied during CID software 
preparation. The data can come from a dialog with the user doing CID software 
preparation, from the output of a user exit program, or from a file or database. 



Figure 161 on page 276| shows an overview of the 



object starting from this kind of ADF. 



process of creating a software 
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ADF 




Figure 161. Generating a Software Object - the process 



Creating an Application Definition File 

To create your own application definition file for any CID-enabled product, follow one of 
these two approaches, depending on the type of application definition file you want to 
create: 

1 Application definition file that points to an external response file 

a Create a file called <product name>.ADF. 

b Use the following example as a model; change the @DEF section and the 
installation command section as shown in the example. The lines to be 
changed are marked with “xxxxxx”. 
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@DEF 

* ******************************************************************************* 



* Descr is not specified here; it is the icon title 

* 



* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 



Name is the short name of the product (max. 16 char) 

BaseProd is the short name of the Package that is the product name without 

explicit references to the version/release. 

Release is the version/release of the product (no dots allowed) 

Level is the maintenance Level of the product 

Platform is the required Operating System: 0S2 or DOS 

Category is the type of application: OpSys, LANTrans, Distr, Application, CSD 

Manufacturer is the name of the company that produced the package 

Language is the NLS version of the product 

DefCfgFile is the file (*.NDI) that defines the default configurations 

CfType is the software object type (REF, CSD, or FIX) 



* ******************************************************************************* 



Description 


"xxxxxxxxxxx" 




Name 


XXXXXXX 


(Up to 


16 Characters) 


BaseProd 


xxxxxxx 


(Up to 


16 Characters) 


Release 


xxxxxxx 


(Up to 


16 Numeric Characters) 


Level 


xxxxxxx 


(Up to 


16 Numeric Characters) 


PI atform 


xxxxxxx 


(Up to 


16 Characters) 


Category 


Application 




Language 


xxxxx 


(Up to 


16 Characters) 


Manufacturer 


IBM 







OENDDEF 
0 1 MG LOAD 



* ******************************************************************************* 



* This section provides the information necessary to locate 

* product images on CD-ROM or diskette, upload the images to 

* the code server, add the product to the software library, and, 

* optionally, create and catalog a default configuration. 

* 



* 

* 

* 



* 



* 



* 



* 

* 



Prompt 
MarkerFi 1 e 
Vol umeLabel 
SourcePath 
Command 

Userlnteract 

GoodRC 



is the message text to display to the user (for example, “Insert 
Diskette 1”). 

is a file on the diskette; if it is missing, the diskette 
is the wrong one. 

is the diskette label. Either MarkerFi le or Vol umeLabel 
is required. 

is the path to the images in the image drive. They will be copied 

to the target drive under the same path. 

is the product upload program (XCOPY or another program). 

In the invocation, variables for source path and target 
directory may be used. 

is YES if the upload program requests user data, NO otherwise 

is the successful return code from the upload program. The default is 0. 



* ******************************************************************************* 



@STEP<1> 

Prompt = "xxxxxxx" 
MarkerFi le = xxxxxxx 
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VolumeLabel = xxxxxxx 
SourcePath = xxxxxxx 
Command = XCOPY $T\CLIENT_W 
Userlnteract = YES 
GoodRC = 0 
@ENDSTEP<1> 

0ENDIMGLOAD 

* kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* Parameter section 

* This section lists all the parameters that are used during the process 

* of generating response and change files; the values are collected 

* when you configure this software 

* kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

@VAR 

* kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* The following included file contains variables about the set-up of 

* the code server 

k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

©INCLUDE CSREMOTE.VAR 

k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* The following section contains the command to install and 

* uninstall the product 

* Use special symbols 

* $S to specify the path containing the product images 

* $R to specify the response file 

* $B to specify the boot drive 

* $Ll-5 to specify up to 5 log files 

* $L to specify the first log file 

* Each of them has a corresponding SDM_xxxxxx keyword in the 

* SDMCMDS.VAR that translates the command in the 

* TME 10 Software Distribution format. 

* Note: 

* It is recommended to specify the drive or directory in which to install 

* the software as a keyword of the response file rather than a parameter 

* of the command line. 

* kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

Section Commands 

{ 

Instal 1 Program 

{ 

"XXXXX.EXE" 

} 

Instal 1 Parms 

{ 

"/S:$S / R : $ R /L1:$L1 /L2:$L2 /L3:$L3" 

} 



UninstallAllowed { 0 } 
Uni nstal 1 Program 

{ 

"XXXXXXX . EXE" 

} 
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Uni nstal 1 Parms 

{ 

"/S:$S / R : $ R /L1:$L1 /L4:$L4 /A: D" 

} 

} 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

** INCLUDE here the configuration keywords that will be used in the 
** model response file for the specified product 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

k 

0ENDVAR 

k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* Change File Profile skeleton section 

k 

* WARNING: do not change the lines between @MCF and 0ENDMCF 

* kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

@MCF 

©INCLUDE CID.MCF 
@ENDMCF 

k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

* Response File skeleton section 

k 

* Specify the name of the model response file in the include statement; 

* the model R/F is a skeleton of a response file with place-holders 

* instead of keyword value and conditional statements to include or exclude 

* part of the file, depending on the value of some configuration keywords. 

k kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

@MRF 

©INCLUDE DUMMY. MRF 
0ENDMRF 

2 Application definition file for response file generation 

a Create files called <product name>.ADF, <product name>.MRF, and 
<product name>.VAR. 

Refer to “Preparing an Application Definition File” in the TME 10 Software 
Distribution Information folder for detailed coding instructions. 



The variable UninstallAllowed within an ADF can assume one of the following values: 

0 The product cannot be uninstalled using CID. 

1 The product can be uninstalled using CID 



If you set the variable UninstallAllowed = 1 in the ADF of the product to allow 
uninstallation, during the software preparation task you must: 

• Set the variable Remote Response File = Yes in the Distribution page of the 
configuration notebook 

• Specify on the same page the name of the external response file and the 
subdirectory where the response file is stored. 
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To accomplish the tasks listed below, you must set the required environment variables. 

To set an environment variable permanently, save it in the CONFIG.SYS file and reboot 
the workstation. For example, to set ACT_ON_TARGET to 1 permanently, set the 
following in the CONFIG.SYS file: 

set ACT_0N_TARGET=1 



Setting Compression or Decompression at the Local Server or at the Destination 
Target 

Set the ACT_ON_TARGET environment variable to choose whether the transmitted file 
is to be compressed or decompressed at your local server or at the destination target. 

Valid values and their meaning are the following: 

0 The compression and decompression are performed at your local server. 

1 The compression and decompression are performed at the destination target. 

For targets that have TME 10 Software Distribution version prior to Version 3.1 
installed, this variable can be set only to 0, which is the default value. 



Improving the Performance of the Database Access Mechanism on OS/2 4.0 

Set the CNDX_DEF_FREQ environment variable and the DISKCACHE=D,LW variable 
to increase the performance of the database by up to 70%. These variables affect the 
access mechanism. 

You must set the variables in the CONFIG.SYS file as follows: 

set CNDX_DEF_FREQ=YES 
set DISKCACHE=D, LW 

The DISKCACFIE=D,LW variable enables the LazyWrite feature of OS/2, which in the 
case of a power-off of the workstation or a power blackout, can preserve the integrity 
of the database. It is recommended to back up the <product_dir >\ DB directory before 
distributing data. 



Preventing the Loss of Icons When Performing CID Installations 

Set the FNDACTDELAY environment variable to seconds, where seconds can be an 
unlimited numbers of seconds, to prevent the loss of icons when performing a CID 
installation. If you set this variable the system reboot is delayed for the specified 
number of seconds. If you set this variable, the icons will be correctly updated and 
OS/2 can refresh its buffer correctly because the system does not reboot immediately 
after the CID installation. If you do not set FNDACTDELAY, the system reboots 
immediately after the CID installation is completed. 
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Activating an Immediate Reboot 

Set the FNDACTIMMEDIATE environment variable to a value to reboot the machine 
immediately when an activate request is received. If you set FNDACTIMMEDIATE, the 
TME 10 Software Distribution Activate pop-up window that prompts you to specify a 
delayed or immediate reboot no longer displays. Do not use this variable normally 
because it causes an immediate reboot. 



Avoiding a Check of Diskette in the Drive 

Set the FNDCFIECKBOOT environment variable to a value so that the activate process 
does not perform a check that verifies if a diskette has been inserted in the drive. 



Using TME 10 Software Distribution for OS/2 Client with the Windows NT 
Server Multiprocessor via NetBIOS 

If you use the TME 10 Software Distribution for OS/2 Client via NetBIOS on an 
underpowered workstation, connected for example to a multiprocessor server, you may 
experience connection problems. To avoid these problems, set the following variable in 
the CONFIG.SYS file: 

set FNDNB0S2 = YES 
then restart the workstation. 



Disabling a Pre-Request Script Process 

Set the FNDACTREQUESTS environment variable to NO to disactivate the 
pre-requests script processing. 



Collecting Product Trace Information 

Set the following environment variables to collect product trace information: 

FNDITRC 

General. Sets the product trace for all the component 

FNDITRC_CO 

COmmon Routines. Sets the product trace for the common routines. 

FNDITRC_DAS 

Database Access Services. Sets the product trace for the database 
access services. 

FNDITRC_GI 

Graphical Interface. Sets the product trace for the graphical interface. 

You can set a value from 0 to 6. Setting the value to 0 causes the maximum level of 
details to display. Setting the value to 6 the traces are not set. These variables will be 
read when the first task starts. 
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Showing Milliseconds in the Date and Time Field 

Set the FNDLOGMSEC environment variable to a value to add milliseconds in the date 
and time format of the FNDLOG. Do not use the message log GUI when the FNDLOG 
file has the date and time in the millisecond format because the GUI cannot display the 
FNDLOG content. This variable must be set to provide better performance 
measurements only. 



Disabling the User ID and Password 

Set the FNDUSER and FNDPASSWORD environment variable to userid and password 
respectively if you do not want to enter the user ID and password either when you start 
the GUI or after you enter a command from the command line. 



Setting the Full Path Name of a Trace File 

Set the FNDUEX_TRC environment variable to define the full path name of a trace file. 
User exits use this file to append the trace data. This variable can be set for user exits 
only. 



Setting a GUI Retry Time 

Set the GI_RETRY_TIME environment variable to establish the timeout for displaying 
the GUI. Specify a value in seconds. The default value is 40. 



Improving the Performance of the Target History Dialog 

Set the HIDE_HIST_CM_PB environment variable to improve the performance of the 
Target History Dialog window. To cause the Target History Dialog window to be 
displayed faster, set HIDE_HIST_CM_PB to yes. 

If you do this, the buttons for the CM functions are not displayed. To execute the CM 
functions, go to the Catalog window. 



Setting a Server-to-Server Permanent Connection 

Set the STS_PERM_CONN environment variable to establish a permanent 
server-to-server (STS) connection and to start a task for each connection. 

The variable can be either YES, NO or a numeric value expressed in milliseconds. For 
example, if you set STS_PERM_CONNECTION to YES and the connection process is 
inactive, the STS connection is active for the time value specified in the 
STSJDLE_TIME variable. The process checks every three seconds if there are 
resources to process. 

If you set the STS_PERM_CONNECTION variable to a numeric value, for example 
5000, the process checks if there are resources to process every 5000 milliseconds. 
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To save memory usage, if you do not have a constant traffic rate, do not set this 
variable. 
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